0000: 3c 74 69 74 6c 65 3e 46 69 6c 65 20 46 6f 72 6d <title>File Form
0010: 61 74 20 46 6f 72 20 53 51 4c 69 74 65 20 44 61 at For SQLite Da
0020: 74 61 62 61 73 65 73 3c 2f 74 69 74 6c 65 3e 0a tabases</title>.
0030: 3c 74 63 6c 3e 68 64 5f 6b 65 79 77 6f 72 64 73 <tcl>hd_keywords
0040: 20 7b 66 69 6c 65 20 66 6f 72 6d 61 74 20 72 65 {file format re
0050: 64 75 78 7d 3c 2f 74 63 6c 3e 0a 0a 3c 68 31 20 dux}</tcl>..<h1
0060: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 0a 54 68 align=center>.Th
0070: 65 20 53 51 4c 69 74 65 20 44 61 74 61 62 61 73 e SQLite Databas
0080: 65 20 46 69 6c 65 20 46 6f 72 6d 61 74 0a 3c 2f e File Format.</
0090: 68 31 3e 0a 0a 3c 70 3e 54 68 69 73 20 64 6f 63 h1>..<p>This doc
00a0: 75 6d 65 6e 74 20 64 65 73 63 72 69 62 65 73 20 ument describes
00b0: 61 6e 64 20 64 65 66 69 6e 65 73 20 74 68 65 20 and defines the
00c0: 6f 6e 2d 64 69 73 6b 20 64 61 74 61 62 61 73 65 on-disk database
00d0: 20 66 69 6c 65 0a 66 6f 72 6d 61 74 20 75 73 65 file.format use
00e0: 64 20 62 79 20 53 51 4c 69 74 65 2e 3c 2f 70 3e d by SQLite.</p>
00f0: 0a 0a 3c 70 3e 54 68 69 73 20 69 73 20 74 68 65 ..<p>This is the
0100: 20 73 65 63 6f 6e 64 20 64 6f 63 75 6d 65 6e 74 second document
0110: 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 53 to define the S
0120: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 66 QLite database f
0130: 69 6c 65 20 66 6f 72 6d 61 74 2e 0a 54 68 65 20 ile format..The
0140: 5b 66 69 6c 65 20 66 6f 72 6d 61 74 7c 20 66 69 [file format| fi
0150: 72 73 74 20 64 6f 63 75 6d 65 6e 74 5d 20 64 69 rst document] di
0160: 66 66 65 72 73 20 66 72 6f 6d 20 74 68 69 73 20 ffers from this
0170: 6f 6e 65 20 69 6e 20 74 68 61 74 20 69 74 20 69 one in that it i
0180: 73 0a 77 72 69 74 74 65 6e 20 69 6e 20 61 20 66 s.written in a f
0190: 6f 72 6d 61 6c 20 73 74 79 6c 65 20 77 68 65 72 ormal style wher
01a0: 65 61 73 20 74 68 69 73 20 64 6f 63 75 6d 65 6e eas this documen
01b0: 74 20 61 74 74 65 6d 70 74 73 20 74 6f 20 62 65 t attempts to be
01c0: 20 6d 6f 72 65 0a 63 6f 6e 76 65 72 73 61 74 69 more.conversati
01d0: 6f 6e 61 6c 2e 20 20 54 68 65 20 74 77 6f 20 64 onal. The two d
01e0: 6f 63 75 6d 65 6e 74 73 20 77 65 72 65 20 69 6e ocuments were in
01f0: 64 65 70 65 6e 64 65 6e 74 6c 79 20 77 72 69 74 dependently writ
0200: 74 65 6e 20 28 74 68 65 79 20 68 61 76 65 0a 64 ten (they have.d
0210: 69 66 66 65 72 65 6e 74 20 61 75 74 68 6f 72 73 ifferent authors
0220: 29 20 61 6e 64 20 68 65 6e 63 65 20 73 65 72 76 ) and hence serv
0230: 65 20 61 73 20 63 72 6f 73 73 2d 63 68 65 63 6b e as cross-check
0240: 73 20 66 6f 72 20 6f 6e 65 20 61 6e 6f 74 68 65 s for one anothe
0250: 72 2e 0a 42 6f 74 68 20 64 6f 63 75 6d 65 6e 74 r..Both document
0260: 73 20 73 68 6f 75 6c 64 20 64 65 73 63 72 69 62 s should describ
0270: 65 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 e exactly the sa
0280: 6d 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 20 me file format.
0290: 20 0a 41 6e 79 20 64 69 73 63 72 65 70 65 6e 63 .Any discrepenc
02a0: 69 65 73 20 62 65 74 77 65 65 6e 20 74 68 65 20 ies between the
02b0: 74 77 6f 20 64 6f 63 75 6d 65 6e 74 73 20 73 68 two documents sh
02c0: 6f 75 6c 64 20 62 65 20 63 6f 6e 73 69 64 65 72 ould be consider
02d0: 65 64 20 61 20 62 75 67 2e 3c 2f 70 3e 0a 0a 3c ed a bug.</p>..<
02e0: 68 32 3e 31 2e 30 20 54 68 65 20 44 61 74 61 62 h2>1.0 The Datab
02f0: 61 73 65 20 46 69 6c 65 3c 2f 68 32 3e 0a 0a 3c ase File</h2>..<
0300: 70 3e 4d 6f 73 74 20 6f 66 20 74 68 65 20 74 69 p>Most of the ti
0310: 6d 65 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 me the complete
0320: 73 74 61 74 65 20 6f 66 20 61 6e 20 53 51 4c 69 state of an SQLi
0330: 74 65 20 64 61 74 61 62 61 73 65 20 0a 69 73 20 te database .is
0340: 63 6f 6e 74 61 69 6e 65 64 20 61 20 73 69 6e 67 contained a sing
0350: 6c 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 20 le file on disk
0360: 63 61 6c 6c 65 64 20 74 68 65 20 22 6d 61 69 6e called the "main
0370: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 22 2e database file".
0380: 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 69 6c 65 20 70 </p>..<p>While p
0390: 65 72 66 6f 72 6d 69 6e 67 20 61 20 74 72 61 6e erforming a tran
03a0: 73 61 63 74 69 6f 6e 2c 20 53 51 4c 69 74 65 20 saction, SQLite
03b0: 73 74 6f 72 65 73 20 73 6f 6d 65 20 74 65 6d 70 stores some temp
03c0: 6f 72 61 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f orary informatio
03d0: 6e 0a 69 6e 20 61 20 73 65 63 6f 6e 64 20 66 69 n.in a second fi
03e0: 6c 65 20 63 61 6c 6c 65 64 20 74 68 65 20 22 72 le called the "r
03f0: 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 22 ollback journal"
0400: 2e 20 20 49 66 20 74 68 65 20 61 70 70 6c 69 63 . If the applic
0410: 61 74 69 6f 6e 20 6f 72 0a 68 6f 73 74 20 63 6f ation or.host co
0420: 6d 70 75 74 65 72 20 63 72 61 73 68 65 73 20 62 mputer crashes b
0430: 65 66 6f 72 65 20 63 6f 6d 70 6c 65 74 69 6e 67 efore completing
0440: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
0450: 2c 20 74 68 65 6e 20 74 68 65 20 72 6f 6c 6c 62 , then the rollb
0460: 61 63 6b 0a 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 ack.journal cont
0470: 61 69 6e 73 20 63 72 69 74 69 63 61 6c 20 73 74 ains critical st
0480: 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ate information
0490: 6e 65 65 64 65 64 20 74 6f 20 72 65 73 74 6f 72 needed to restor
04a0: 65 20 74 68 65 0a 63 6f 6e 74 65 6e 74 20 6f 66 e the.content of
04b0: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 the main databa
04c0: 73 65 20 66 69 6c 65 2e 20 20 57 68 65 6e 20 61 se file. When a
04d0: 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
04e0: 6c 20 63 6f 6e 74 61 69 6e 73 0a 69 6e 66 6f 72 l contains.infor
04f0: 6d 61 74 69 6f 6e 20 6e 65 63 65 73 73 61 72 79 mation necessary
0500: 20 66 6f 72 20 72 65 63 6f 76 65 72 69 6e 67 20 for recovering
0510: 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 the state of the
0520: 20 64 61 74 61 62 61 73 65 2c 20 77 65 20 73 61 database, we sa
0530: 79 0a 74 68 61 74 20 69 74 20 69 73 20 61 20 22 y.that it is a "
0540: 68 6f 74 20 6a 6f 75 72 6e 61 6c 22 2e 20 20 48 hot journal". H
0550: 6f 74 20 6a 6f 75 72 6e 61 6c 73 20 6f 6e 6c 79 ot journals only
0560: 20 63 6f 6d 65 20 75 70 20 69 6e 20 61 6e 20 65 come up in an e
0570: 72 72 6f 72 20 72 65 63 6f 76 65 72 79 0a 73 63 rror recovery.sc
0580: 65 6e 61 72 69 6f 20 61 6e 64 20 73 6f 20 61 72 enario and so ar
0590: 65 20 75 6e 63 6f 6d 6d 6f 6e 2c 20 62 75 74 20 e uncommon, but
05a0: 74 68 65 79 20 61 72 65 20 70 61 72 74 20 6f 66 they are part of
05b0: 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 61 6e the state of an
05c0: 20 53 51 4c 69 74 65 0a 64 61 74 61 62 61 73 65 SQLite.database
05d0: 20 61 6e 64 20 73 6f 20 73 68 6f 75 6c 64 20 6e and so should n
05e0: 6f 74 20 62 65 20 69 67 6e 6f 72 65 64 2e 20 20 ot be ignored.
05f0: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 77 69 This document wi
0600: 6c 6c 20 64 65 66 69 6e 65 20 74 68 65 20 66 6f ll define the fo
0610: 72 6d 61 74 0a 6f 66 20 61 20 72 6f 6c 6c 62 61 rmat.of a rollba
0620: 63 6b 20 6a 6f 75 72 6e 61 6c 2c 20 62 75 74 20 ck journal, but
0630: 6d 6f 73 74 20 6f 66 20 74 68 65 20 63 6f 6e 74 most of the cont
0640: 65 6e 74 20 6f 66 20 74 68 69 73 20 64 6f 63 75 ent of this docu
0650: 6d 65 6e 74 20 77 69 6c 6c 20 66 6f 63 75 73 0a ment will focus.
0660: 6f 6e 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 on the main data
0670: 62 61 73 65 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a base file.</p>..
0680: 3c 68 33 3e 31 2e 31 20 50 61 67 65 73 3c 2f 68 <h3>1.1 Pages</h
0690: 33 3e 0a 0a 3c 70 3e 54 68 65 20 6d 61 69 6e 20 3>..<p>The main
06a0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 63 6f database file co
06b0: 6e 73 69 73 74 73 20 6f 66 20 6f 6e 65 20 6f 72 nsists of one or
06c0: 20 6d 6f 72 65 20 70 61 67 65 73 2e 20 20 54 68 more pages. Th
06d0: 65 20 73 69 7a 65 20 6f 66 20 61 0a 70 61 67 65 e size of a.page
06e0: 20 69 73 20 61 20 70 6f 77 65 72 20 6f 66 20 74 is a power of t
06f0: 77 6f 20 62 65 74 77 65 65 6e 20 35 31 32 20 61 wo between 512 a
0700: 6e 64 20 33 32 37 36 38 20 69 6e 63 6c 75 73 69 nd 32768 inclusi
0710: 76 65 2e 20 20 41 6c 6c 20 70 61 67 65 73 20 77 ve. All pages w
0720: 69 74 68 69 6e 0a 74 68 65 20 73 61 6d 65 20 64 ithin.the same d
0730: 61 74 61 62 61 73 65 20 61 72 65 20 74 68 65 20 atabase are the
0740: 73 61 6d 65 20 73 69 7a 65 2e 20 20 54 68 65 20 same size. The
0750: 70 61 67 65 20 73 69 7a 65 20 66 6f 72 20 61 20 page size for a
0760: 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 69 73 database file.is
0770: 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 determined by t
0780: 68 65 20 32 2d 62 79 74 65 20 62 69 67 2d 65 6e he 2-byte big-en
0790: 64 69 61 6e 20 69 6e 74 65 67 65 72 20 6c 6f 63 dian integer loc
07a0: 61 74 65 64 20 61 74 20 61 6e 20 6f 66 66 73 65 ated at an offse
07b0: 74 20 6f 66 0a 31 36 20 62 79 74 65 73 20 66 72 t of.16 bytes fr
07c0: 6f 6d 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 om the beginning
07d0: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
07e0: 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 50 file.</p>..<p>P
07f0: 61 67 65 73 20 61 72 65 20 6e 75 6d 62 65 72 65 ages are numbere
0800: 64 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 d beginning with
0810: 20 31 2e 20 20 54 68 65 20 6d 61 78 69 6d 75 6d 1. The maximum
0820: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 0a page number is.
0830: 32 31 34 37 34 38 33 36 34 36 20 28 32 3c 73 75 2147483646 (2<su
0840: 70 3e 3c 73 6d 61 6c 6c 3e 33 31 3c 2f 73 6d 61 p><small>31</sma
0850: 6c 6c 3e 3c 2f 73 75 70 3e 20 2d 20 32 29 2e 20 ll></sup> - 2).
0860: 20 54 68 65 20 6d 69 6e 69 6d 75 6d 20 73 69 7a The minimum siz
0870: 65 0a 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 e.SQLite databas
0880: 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20 35 31 e is a single 51
0890: 32 2d 62 79 74 65 20 70 61 67 65 2e 0a 54 68 65 2-byte page..The
08a0: 20 6d 61 78 69 6d 75 6d 20 73 69 7a 65 20 64 61 maximum size da
08b0: 74 61 62 61 73 65 20 77 6f 75 6c 64 20 62 65 20 tabase would be
08c0: 32 31 34 37 34 38 33 36 34 36 20 70 61 67 65 73 2147483646 pages
08d0: 20 61 74 20 33 32 37 36 38 20 62 79 74 65 73 20 at 32768 bytes
08e0: 70 65 72 0a 70 61 67 65 20 6f 72 20 37 30 2c 33 per.page or 70,3
08f0: 36 38 2c 37 34 34 2c 31 31 32 2c 31 32 38 20 62 68,744,112,128 b
0900: 79 74 65 73 20 28 61 62 6f 75 74 20 37 30 20 74 ytes (about 70 t
0910: 65 72 61 62 79 74 65 73 29 2e 20 20 55 73 75 61 erabytes). Usua
0920: 6c 6c 79 20 53 51 4c 69 74 65 20 77 69 6c 6c 0a lly SQLite will.
0930: 68 69 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 hit the maximum
0940: 66 69 6c 65 20 73 69 7a 65 20 6c 69 6d 69 74 20 file size limit
0950: 6f 66 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e of the underlyin
0960: 67 20 66 69 6c 65 73 79 73 74 65 6d 20 6f 72 20 g filesystem or
0970: 64 69 73 6b 0a 68 61 72 64 77 61 72 65 20 73 69 disk.hardware si
0980: 7a 65 20 6c 69 6d 69 74 20 6c 6f 6e 67 20 62 65 ze limit long be
0990: 66 6f 72 65 20 69 74 20 68 69 74 73 20 69 74 73 fore it hits its
09a0: 20 6f 77 6e 20 69 6e 74 65 72 6e 61 6c 20 73 69 own internal si
09b0: 7a 65 20 6c 69 6d 69 74 2e 3c 2f 70 3e 0a 0a 3c ze limit.</p>..<
09c0: 70 3e 49 6e 20 63 6f 6d 6d 6f 6e 20 75 73 65 2c p>In common use,
09d0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
09e0: 73 20 74 65 6e 64 20 74 6f 20 72 61 6e 67 65 20 s tend to range
09f0: 69 6e 20 73 69 7a 65 20 66 72 6f 6d 20 61 20 66 in size from a f
0a00: 65 77 20 6b 69 6c 6f 62 79 74 65 73 0a 74 6f 20 ew kilobytes.to
0a10: 61 20 66 65 77 20 67 69 67 61 62 79 74 65 73 2e a few gigabytes.
0a20: 3c 2f 70 3e 0a 0a 3c 70 3e 41 74 20 61 6e 79 20 </p>..<p>At any
0a30: 70 6f 69 6e 74 20 69 6e 20 74 69 6d 65 2c 20 65 point in time, e
0a40: 76 65 72 79 20 70 61 67 65 20 69 6e 20 74 68 65 very page in the
0a50: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 68 main database h
0a60: 61 73 20 61 20 73 69 6e 67 6c 65 0a 75 73 65 20 as a single.use
0a70: 77 68 69 63 68 20 69 73 20 6f 6e 65 20 6f 66 20 which is one of
0a80: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 3c the following:.<
0a90: 75 6c 3e 0a 3c 6c 69 3e 54 68 65 20 6c 6f 63 6b ul>.<li>The lock
0aa0: 2d 62 79 74 65 20 70 61 67 65 0a 3c 6c 69 3e 41 -byte page.<li>A
0ab0: 20 66 72 65 65 6c 69 73 74 20 70 61 67 65 0a 3c freelist page.<
0ac0: 75 6c 3e 0a 3c 6c 69 3e 41 20 66 72 65 65 6c 69 ul>.<li>A freeli
0ad0: 73 74 20 74 72 75 6e 6b 20 70 61 67 65 0a 3c 6c st trunk page.<l
0ae0: 69 3e 41 20 66 72 65 65 6c 69 73 74 20 6c 65 61 i>A freelist lea
0af0: 66 20 70 61 67 65 0a 3c 2f 75 6c 3e 0a 3c 6c 69 f page.</ul>.<li
0b00: 3e 41 20 62 2d 74 72 65 65 20 70 61 67 65 0a 3c >A b-tree page.<
0b10: 75 6c 3e 0a 3c 6c 69 3e 41 20 74 61 62 6c 65 20 ul>.<li>A table
0b20: 62 2d 74 72 65 65 20 69 6e 74 65 72 69 6f 72 20 b-tree interior
0b30: 70 61 67 65 0a 3c 6c 69 3e 41 20 74 61 62 6c 65 page.<li>A table
0b40: 20 62 2d 74 72 65 65 20 6c 65 61 66 20 70 61 67 b-tree leaf pag
0b50: 65 0a 3c 6c 69 3e 41 6e 20 69 6e 64 65 78 20 62 e.<li>An index b
0b60: 2d 74 72 65 65 20 69 6e 74 65 72 69 6f 72 20 70 -tree interior p
0b70: 61 67 65 0a 3c 6c 69 3e 41 6e 20 69 6e 64 65 78 age.<li>An index
0b80: 20 62 2d 74 72 65 65 20 6c 65 61 66 20 70 61 67 b-tree leaf pag
0b90: 65 0a 3c 2f 75 6c 3e 0a 3c 6c 69 3e 41 20 70 61 e.</ul>.<li>A pa
0ba0: 79 6c 6f 61 64 20 6f 76 65 72 66 6c 6f 77 20 70 yload overflow p
0bb0: 61 67 65 0a 3c 6c 69 3e 41 20 70 6f 69 6e 74 65 age.<li>A pointe
0bc0: 72 20 6d 61 70 20 70 61 67 65 0a 3c 2f 75 6c 3e r map page.</ul>
0bd0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 41 6c 6c 20 72 65 .</p>..<p>All re
0be0: 61 64 73 20 66 72 6f 6d 20 61 6e 64 20 77 72 69 ads from and wri
0bf0: 74 65 73 20 74 6f 20 74 68 65 20 6d 61 69 6e 20 tes to the main
0c00: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 65 database file be
0c10: 67 69 6e 20 61 74 20 61 20 70 61 67 65 0a 62 6f gin at a page.bo
0c20: 75 6e 64 61 72 79 20 61 6e 64 20 61 6c 6c 20 77 undary and all w
0c30: 72 69 74 65 73 20 61 72 65 20 61 6e 20 69 6e 74 rites are an int
0c40: 65 67 65 72 20 6e 75 6d 62 65 72 20 6f 66 20 70 eger number of p
0c50: 61 67 65 73 20 69 6e 20 73 69 7a 65 2e 20 20 52 ages in size. R
0c60: 65 61 64 73 0a 61 72 65 20 61 6c 73 6f 20 75 73 eads.are also us
0c70: 75 61 6c 6c 79 20 61 6e 20 69 6e 74 65 67 65 72 ually an integer
0c80: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
0c90: 20 69 6e 20 73 69 7a 65 2c 20 77 69 74 68 20 74 in size, with t
0ca0: 68 65 20 6f 6e 65 20 65 78 63 65 70 74 69 6f 6e he one exception
0cb0: 0a 74 68 61 74 20 77 68 65 6e 20 74 68 65 20 64 .that when the d
0cc0: 61 74 61 62 61 73 65 20 69 73 20 66 69 72 73 74 atabase is first
0cd0: 20 6f 70 65 6e 65 64 2c 20 74 68 65 20 66 69 72 opened, the fir
0ce0: 73 74 20 31 30 30 20 62 79 74 65 73 20 6f 66 20 st 100 bytes of
0cf0: 74 68 65 0a 64 61 74 61 62 61 73 65 20 66 69 6c the.database fil
0d00: 65 20 28 74 68 65 20 64 61 74 61 62 61 73 65 20 e (the database
0d10: 66 69 6c 65 20 68 65 61 64 65 72 29 20 61 72 65 file header) are
0d20: 20 72 65 61 64 20 61 73 20 61 20 73 75 62 2d 70 read as a sub-p
0d30: 61 67 65 20 73 69 7a 65 20 75 6e 69 74 2e 3c 2f age size unit.</
0d40: 70 3e 0a 0a 3c 70 3e 42 65 66 6f 72 65 20 61 6e p>..<p>Before an
0d50: 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2d 62 65 y information-be
0d60: 61 72 69 6e 67 20 70 61 67 65 20 6f 66 20 74 68 aring page of th
0d70: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6d 6f e database is mo
0d80: 64 69 66 69 65 64 2c 20 0a 74 68 65 20 6f 72 69 dified, .the ori
0d90: 67 69 6e 61 6c 20 75 6e 6d 6f 64 69 66 69 65 64 ginal unmodified
0da0: 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 61 74 content of that
0db0: 20 70 61 67 65 20 69 73 20 77 72 69 74 74 65 6e page is written
0dc0: 20 69 6e 74 6f 20 74 68 65 20 0a 72 6f 6c 6c 62 into the .rollb
0dd0: 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e 20 20 49 66 ack journal. If
0de0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
0df0: 73 20 69 6e 74 65 72 72 75 70 74 65 64 20 61 6e s interrupted an
0e00: 64 20 6e 65 65 64 73 20 74 6f 20 62 65 20 0a 72 d needs to be .r
0e10: 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 65 20 olled back, the
0e20: 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
0e30: 20 63 61 6e 20 74 68 65 6e 20 62 65 20 75 73 65 can then be use
0e40: 64 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 d to restore the
0e50: 0a 64 61 74 61 62 61 73 65 20 74 6f 20 69 74 73 .database to its
0e60: 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 65 2e original state.
0e70: 20 20 46 72 65 65 6c 69 73 74 20 6c 65 61 66 20 Freelist leaf
0e80: 70 61 67 65 73 20 62 65 61 72 20 6e 6f 0a 69 6e pages bear no.in
0e90: 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 20 77 formation that w
0ea0: 6f 75 6c 64 20 6e 65 65 64 20 74 6f 20 62 65 20 ould need to be
0eb0: 72 65 73 74 6f 72 65 64 20 6f 6e 20 61 20 72 6f restored on a ro
0ec0: 6c 6c 62 61 63 6b 20 61 6e 64 20 73 6f 20 74 68 llback and so th
0ed0: 65 79 0a 61 72 65 20 6e 6f 74 20 77 72 69 74 74 ey.are not writt
0ee0: 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 en to the journa
0ef0: 6c 20 70 72 69 6f 72 20 74 6f 20 6d 6f 64 69 66 l prior to modif
0f00: 69 63 61 74 69 6f 6e 2c 20 69 6e 20 6f 72 64 65 ication, in orde
0f10: 72 20 74 6f 0a 72 65 64 75 63 65 20 64 69 73 6b r to.reduce disk
0f20: 20 49 2f 4f 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e I/O.</p>..<tcl>
0f30: 68 64 5f 66 72 61 67 6d 65 6e 74 20 64 61 74 61 hd_fragment data
0f40: 62 61 73 65 5f 68 65 61 64 65 72 20 7b 64 61 74 base_header {dat
0f50: 61 62 61 73 65 20 68 65 61 64 65 72 7d 3c 2f 74 abase header}</t
0f60: 63 6c 3e 0a 3c 68 33 3e 31 2e 32 20 54 68 65 20 cl>.<h3>1.2 The
0f70: 44 61 74 61 62 61 73 65 20 48 65 61 64 65 72 3c Database Header<
0f80: 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 66 69 72 /h3>..<p>The fir
0f90: 73 74 20 31 30 30 20 62 79 74 65 73 20 6f 66 20 st 100 bytes of
0fa0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
0fb0: 65 20 63 6f 6d 70 72 69 73 65 20 74 68 65 20 64 e comprise the d
0fc0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 0a 68 65 atabase file .he
0fd0: 61 64 65 72 2e 20 20 54 68 65 20 64 61 74 61 62 ader. The datab
0fe0: 61 73 65 20 66 69 6c 65 20 68 65 61 64 65 72 20 ase file header
0ff0: 69 73 20 64 69 76 69 64 65 64 20 69 6e 74 6f 20 is divided into
1000: 66 69 65 6c 64 73 20 61 73 20 73 68 6f 77 6e 20 fields as shown
1010: 62 79 0a 74 68 65 20 74 61 62 6c 65 20 62 65 6c by.the table bel
1020: 6f 77 2e 20 20 41 6c 6c 20 6d 75 6c 74 69 62 79 ow. All multiby
1030: 74 65 20 66 69 65 6c 64 73 20 69 6e 20 74 68 65 te fields in the
1040: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 database file h
1050: 65 61 64 65 72 20 61 72 65 0a 73 74 6f 72 65 64 eader are.stored
1060: 20 77 69 74 68 20 74 68 65 20 6d 75 73 74 20 73 with the must s
1070: 69 67 6e 69 66 69 63 61 6e 74 20 62 79 74 65 20 ignificant byte
1080: 66 69 72 73 74 20 28 62 69 67 2d 65 6e 64 69 61 first (big-endia
1090: 6e 29 2e 3c 2f 70 3e 0a 0a 3c 63 65 6e 74 65 72 n).</p>..<center
10a0: 3e 0a 3c 69 3e 44 61 74 61 62 61 73 65 20 48 65 >.<i>Database He
10b0: 61 64 65 72 20 46 6f 72 6d 61 74 3c 2f 69 3e 3c ader Format</i><
10c0: 62 72 3e 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 br>.<table width
10d0: 3d 22 38 30 25 22 20 62 6f 72 64 65 72 3d 31 3e ="80%" border=1>
10e0: 0a 3c 74 72 3e 3c 74 68 3e 4f 66 66 73 65 74 3c .<tr><th>Offset<
10f0: 74 68 3e 53 69 7a 65 3c 74 68 3e 44 65 73 63 72 th>Size<th>Descr
1100: 69 70 74 69 6f 6e 0a 3c 74 72 3e 3c 74 64 20 76 iption.<tr><td v
1110: 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d align=top align=
1120: 63 65 6e 74 65 72 3e 30 3c 74 64 20 76 61 6c 69 center>0<td vali
1130: 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e gn=top align=cen
1140: 74 65 72 3e 31 36 3c 74 64 20 61 6c 69 67 6e 3d ter>16<td align=
1150: 6c 65 66 74 3e 0a 54 68 65 20 68 65 61 64 65 72 left>.The header
1160: 20 73 74 72 69 6e 67 3a 20 22 53 51 4c 69 74 65 string: "SQLite
1170: 20 66 6f 72 6d 61 74 20 33 5c 30 30 30 22 0a 3c format 3\000".<
1180: 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f tr><td valign=to
1190: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 p align=center>1
11a0: 36 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 6<td valign=top
11b0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 32 3c 74 align=center>2<t
11c0: 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 54 68 d align=left>.Th
11d0: 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 e database page
11e0: 73 69 7a 65 20 69 6e 20 62 79 74 65 73 2e 20 20 size in bytes.
11f0: 4d 75 73 74 20 62 65 20 61 20 70 6f 77 65 72 20 Must be a power
1200: 6f 66 20 74 77 6f 20 62 65 74 77 65 65 6e 20 35 of two between 5
1210: 31 32 0a 61 6e 64 20 33 32 37 36 38 20 69 6e 63 12.and 32768 inc
1220: 6c 75 73 69 76 65 2e 0a 3c 74 72 3e 3c 74 64 20 lusive..<tr><td
1230: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
1240: 3d 63 65 6e 74 65 72 3e 31 38 3c 74 64 20 76 61 =center>18<td va
1250: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
1260: 65 6e 74 65 72 3e 31 3c 74 64 20 61 6c 69 67 6e enter>1<td align
1270: 3d 6c 65 66 74 3e 0a 46 69 6c 65 20 66 6f 72 6d =left>.File form
1280: 61 74 20 77 72 69 74 65 20 76 65 72 73 69 6f 6e at write version
1290: 2e 20 20 4d 75 73 74 20 62 65 20 31 2e 0a 3c 74 . Must be 1..<t
12a0: 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 r><td valign=top
12b0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 39 align=center>19
12c0: 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 <td valign=top a
12d0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 3c 74 64 lign=center>1<td
12e0: 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 46 69 6c align=left>.Fil
12f0: 65 20 66 6f 72 6d 61 74 20 72 65 61 64 20 76 65 e format read ve
1300: 72 73 69 6f 6e 2e 20 20 4d 75 73 74 20 62 65 20 rsion. Must be
1310: 31 2e 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 1..<tr><td valig
1320: 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 n=top align=cent
1330: 65 72 3e 32 30 3c 74 64 20 76 61 6c 69 67 6e 3d er>20<td valign=
1340: 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 top align=center
1350: 3e 31 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 >1<td align=left
1360: 3e 0a 42 79 74 65 73 20 6f 66 20 75 6e 75 73 65 >.Bytes of unuse
1370: 64 20 22 72 65 73 65 72 76 65 64 22 20 73 70 61 d "reserved" spa
1380: 63 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 ce at the end of
1390: 20 65 61 63 68 20 70 61 67 65 2e 20 20 55 73 75 each page. Usu
13a0: 61 6c 6c 79 20 30 2e 0a 3c 74 72 3e 3c 74 64 20 ally 0..<tr><td
13b0: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
13c0: 3d 63 65 6e 74 65 72 3e 32 31 3c 74 64 20 76 61 =center>21<td va
13d0: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
13e0: 65 6e 74 65 72 3e 31 3c 74 64 20 61 6c 69 67 6e enter>1<td align
13f0: 3d 6c 65 66 74 3e 0a 4d 61 78 69 6d 75 6d 20 65 =left>.Maximum e
1400: 6d 62 65 64 64 65 64 20 70 61 79 6c 6f 61 64 20 mbedded payload
1410: 66 72 61 63 74 69 6f 6e 2e 20 20 4d 75 73 74 20 fraction. Must
1420: 62 65 20 36 34 2e 0a 3c 74 72 3e 3c 74 64 20 76 be 64..<tr><td v
1430: 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d align=top align=
1440: 63 65 6e 74 65 72 3e 32 32 3c 74 64 20 76 61 6c center>22<td val
1450: 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 ign=top align=ce
1460: 6e 74 65 72 3e 31 3c 74 64 20 61 6c 69 67 6e 3d nter>1<td align=
1470: 6c 65 66 74 3e 0a 4d 69 6e 69 6d 75 6d 20 65 6d left>.Minimum em
1480: 62 65 64 64 65 64 20 70 61 79 6c 6f 61 64 20 66 bedded payload f
1490: 72 61 63 74 69 6f 6e 2e 20 20 4d 75 73 74 20 62 raction. Must b
14a0: 65 20 33 32 2e 0a 3c 74 72 3e 3c 74 64 20 76 61 e 32..<tr><td va
14b0: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
14c0: 65 6e 74 65 72 3e 32 33 3c 74 64 20 76 61 6c 69 enter>23<td vali
14d0: 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e gn=top align=cen
14e0: 74 65 72 3e 31 3c 74 64 20 61 6c 69 67 6e 3d 6c ter>1<td align=l
14f0: 65 66 74 3e 0a 4c 65 61 66 20 70 61 79 6c 6f 61 eft>.Leaf payloa
1500: 64 20 66 72 61 63 74 69 6f 6e 2e 20 20 4d 75 73 d fraction. Mus
1510: 74 20 62 65 20 33 32 2e 0a 3c 74 72 3e 3c 74 64 t be 32..<tr><td
1520: 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 valign=top alig
1530: 6e 3d 63 65 6e 74 65 72 3e 32 34 3c 74 64 20 76 n=center>24<td v
1540: 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d align=top align=
1550: 63 65 6e 74 65 72 3e 34 3c 74 64 20 61 6c 69 67 center>4<td alig
1560: 6e 3d 6c 65 66 74 3e 0a 46 69 6c 65 20 63 68 61 n=left>.File cha
1570: 6e 67 65 20 63 6f 75 6e 74 65 72 2e 0a 3c 74 72 nge counter..<tr
1580: 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 ><td valign=top
1590: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 32 38 3c align=center>28<
15a0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
15b0: 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c 74 64 20 ign=center>4<td
15c0: 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 52 65 73 65 align=left>.Rese
15d0: 72 76 65 64 20 66 6f 72 20 65 78 70 61 6e 73 69 rved for expansi
15e0: 6f 6e 2e 20 20 4d 75 73 74 20 62 65 20 7a 65 72 on. Must be zer
15f0: 6f 2e 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 o..<tr><td valig
1600: 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 n=top align=cent
1610: 65 72 3e 33 32 3c 74 64 20 76 61 6c 69 67 6e 3d er>32<td valign=
1620: 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 top align=center
1630: 3e 34 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 >4<td align=left
1640: 3e 0a 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 >.Page number of
1650: 20 74 68 65 20 66 69 72 73 74 20 66 72 65 65 6c the first freel
1660: 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e 0a ist trunk page..
1670: 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 <tr><td valign=t
1680: 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e op align=center>
1690: 33 36 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 36<td valign=top
16a0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c align=center>4<
16b0: 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 54 td align=left>.T
16c0: 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 66 otal number of f
16d0: 72 65 65 6c 69 73 74 20 70 61 67 65 73 2e 0a 3c reelist pages..<
16e0: 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f tr><td valign=to
16f0: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 p align=center>4
1700: 30 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 0<td valign=top
1710: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c 74 align=center>4<t
1720: 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 54 68 d align=left>.Th
1730: 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 2e e schema cookie.
1740: 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d .<tr><td valign=
1750: 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 top align=center
1760: 3e 34 34 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f >44<td valign=to
1770: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 p align=center>4
1780: 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a <td align=left>.
1790: 54 68 65 20 73 63 68 65 6d 61 20 66 6f 72 6d 61 The schema forma
17a0: 74 20 6e 75 6d 62 65 72 2e 20 20 43 75 72 72 65 t number. Curre
17b0: 6e 74 6c 79 20 73 75 70 70 6f 72 74 20 73 63 68 ntly support sch
17c0: 65 6d 61 20 66 6f 72 6d 61 74 73 20 61 72 65 20 ema formats are
17d0: 31 2c 20 32 2c 20 33 2c 20 61 6e 64 20 34 2e 0a 1, 2, 3, and 4..
17e0: 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 <tr><td valign=t
17f0: 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e op align=center>
1800: 34 38 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 48<td valign=top
1810: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c align=center>4<
1820: 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 44 td align=left>.D
1830: 65 66 61 75 6c 74 20 70 61 67 65 20 63 61 63 68 efault page cach
1840: 65 20 73 69 7a 65 2e 0a 3c 74 72 3e 3c 74 64 20 e size..<tr><td
1850: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
1860: 3d 63 65 6e 74 65 72 3e 35 32 3c 74 64 20 76 61 =center>52<td va
1870: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
1880: 65 6e 74 65 72 3e 34 3c 74 64 20 61 6c 69 67 6e enter>4<td align
1890: 3d 6c 65 66 74 3e 0a 54 68 65 20 70 61 67 65 20 =left>.The page
18a0: 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 6c 61 number of the la
18b0: 72 67 65 73 74 20 72 6f 6f 74 20 62 2d 74 72 65 rgest root b-tre
18c0: 65 20 70 61 67 65 20 77 68 65 6e 20 69 6e 20 61 e page when in a
18d0: 75 74 6f 2d 76 61 63 75 75 6d 20 6f 72 0a 69 6e uto-vacuum or.in
18e0: 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 75 6d cremental-vacuum
18f0: 20 6d 6f 64 65 73 2c 20 6f 72 20 7a 65 72 6f 20 modes, or zero
1900: 6f 74 68 65 72 77 69 73 65 2e 0a 3c 74 72 3e 3c otherwise..<tr><
1910: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
1920: 69 67 6e 3d 63 65 6e 74 65 72 3e 35 36 3c 74 64 ign=center>56<td
1930: 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 valign=top alig
1940: 6e 3d 63 65 6e 74 65 72 3e 34 3c 74 64 20 61 6c n=center>4<td al
1950: 69 67 6e 3d 6c 65 66 74 3e 0a 54 68 65 20 64 61 ign=left>.The da
1960: 74 61 62 61 73 65 20 74 65 78 74 20 65 6e 63 6f tabase text enco
1970: 64 69 6e 67 2e 20 20 41 20 76 61 6c 75 65 20 6f ding. A value o
1980: 66 20 31 20 6d 65 61 6e 73 20 55 54 46 2d 38 2e f 1 means UTF-8.
1990: 20 20 41 20 76 61 6c 75 65 20 6f 66 20 32 0a 6d A value of 2.m
19a0: 65 61 6e 73 20 55 54 46 2d 31 36 6c 65 2e 20 20 eans UTF-16le.
19b0: 41 20 76 61 6c 75 65 20 6f 66 20 33 20 6d 65 61 A value of 3 mea
19c0: 6e 73 20 55 54 46 2d 31 36 62 65 2e 0a 3c 74 72 ns UTF-16be..<tr
19d0: 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 ><td valign=top
19e0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 36 30 3c align=center>60<
19f0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
1a00: 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c 74 64 20 ign=center>4<td
1a10: 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 54 68 65 20 align=left>.The
1a20: 22 75 73 65 72 20 76 65 72 73 69 6f 6e 22 20 61 "user version" a
1a30: 73 20 72 65 61 64 20 61 6e 64 20 73 65 74 20 62 s read and set b
1a40: 79 20 74 68 65 20 5b 75 73 65 72 5f 76 65 72 73 y the [user_vers
1a50: 69 6f 6e 20 70 72 61 67 6d 61 5d 2e 0a 3c 74 72 ion pragma]..<tr
1a60: 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 ><td valign=top
1a70: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 36 34 3c align=center>64<
1a80: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
1a90: 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c 74 64 20 ign=center>4<td
1aa0: 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 54 72 75 65 align=left>.True
1ab0: 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 66 6f 72 20 (non-zero) for
1ac0: 69 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 incremental-vacu
1ad0: 75 6d 20 6d 6f 64 65 2e 20 20 46 61 6c 73 65 20 um mode. False
1ae0: 28 7a 65 72 6f 29 20 6f 74 68 65 72 77 69 73 65 (zero) otherwise
1af0: 2e 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e ..<tr><td valign
1b00: 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 =top align=cente
1b10: 72 3e 36 38 3c 74 64 20 76 61 6c 69 67 6e 3d 74 r>68<td valign=t
1b20: 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e op align=center>
1b30: 33 32 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 32<td align=left
1b40: 3e 0a 52 65 73 65 72 76 65 64 20 66 6f 72 20 65 >.Reserved for e
1b50: 78 70 61 6e 73 69 6f 6e 2e 20 20 4d 75 73 74 20 xpansion. Must
1b60: 62 65 20 7a 65 72 6f 2e 0a 3c 2f 74 61 62 6c 65 be zero..</table
1b70: 3e 3c 2f 63 65 6e 74 65 72 3e 0a 0a 3c 70 3e 45 ></center>..<p>E
1b80: 76 65 72 79 20 53 51 4c 69 74 65 20 64 61 74 61 very SQLite data
1b90: 62 61 73 65 20 66 69 6c 65 20 62 65 67 69 6e 73 base file begins
1ba0: 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 with the follow
1bb0: 69 6e 67 20 31 36 20 62 79 74 65 73 20 28 69 6e ing 16 bytes (in
1bc0: 20 68 65 78 29 3a 0a 35 33 20 35 31 20 34 63 20 hex):.53 51 4c
1bd0: 36 39 20 37 34 20 36 35 20 32 30 20 36 36 20 36 69 74 65 20 66 6
1be0: 66 20 37 32 20 36 64 20 36 31 20 37 34 20 32 30 f 72 6d 61 74 20
1bf0: 20 33 33 20 30 30 2e 20 20 54 68 69 73 20 62 79 33 00. This by
1c00: 74 65 20 73 65 71 75 65 6e 63 65 0a 63 6f 72 72 te sequence.corr
1c10: 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 55 esponds to the U
1c20: 54 46 2d 38 20 73 74 72 69 6e 67 20 22 53 51 4c TF-8 string "SQL
1c30: 69 74 65 20 66 6f 72 6d 61 74 20 33 22 20 69 6e ite format 3" in
1c40: 63 6c 75 64 69 6e 67 20 74 68 65 20 6e 75 6c 0a cluding the nul.
1c50: 74 65 72 6d 69 6e 61 74 6f 72 20 63 68 61 72 61 terminator chara
1c60: 63 74 65 72 20 61 74 20 74 68 65 20 65 6e 64 2e cter at the end.
1c70: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 66 69 6c </p>..<p>The fil
1c80: 65 20 66 6f 72 6d 61 74 20 77 72 69 74 65 20 76 e format write v
1c90: 65 72 73 69 6f 6e 20 61 6e 64 20 66 69 6c 65 20 ersion and file
1ca0: 66 6f 72 6d 61 74 20 72 65 61 64 20 76 65 72 73 format read vers
1cb0: 69 6f 6e 20 61 74 20 6f 66 66 73 65 74 73 0a 31 ion at offsets.1
1cc0: 38 20 61 6e 64 20 31 39 20 61 72 65 20 69 6e 74 8 and 19 are int
1cd0: 65 6e 64 65 64 20 74 6f 20 61 6c 6c 6f 77 20 66 ended to allow f
1ce0: 6f 72 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 20 or enhancements
1cf0: 6f 66 20 74 68 65 20 66 69 6c 65 20 66 6f 72 6d of the file form
1d00: 61 74 0a 69 6e 20 66 75 74 75 72 65 20 76 65 72 at.in future ver
1d10: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2e sions of SQLite.
1d20: 20 20 49 6e 20 63 75 72 72 65 6e 74 20 76 65 72 In current ver
1d30: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2c sions of SQLite,
1d40: 20 62 6f 74 68 20 6f 66 0a 74 68 65 73 65 20 76 both of.these v
1d50: 61 6c 75 65 73 20 6d 75 73 74 20 62 65 20 6f 6e alues must be on
1d60: 65 2e 20 20 49 66 20 61 20 76 65 72 73 69 6f 6e e. If a version
1d70: 20 6f 66 20 53 51 4c 69 74 65 20 63 6f 64 65 64 of SQLite coded
1d80: 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 0a to the current.
1d90: 66 69 6c 65 20 66 6f 72 6d 61 74 20 73 70 65 63 file format spec
1da0: 69 66 69 63 61 74 69 6f 6e 20 65 6e 63 6f 75 6e ification encoun
1db0: 74 65 72 73 20 61 20 64 61 74 61 62 61 73 65 20 ters a database
1dc0: 66 69 6c 65 20 77 68 65 72 65 20 74 68 65 20 72 file where the r
1dd0: 65 61 64 0a 76 65 72 73 69 6f 6e 20 69 73 20 31 ead.version is 1
1de0: 20 62 75 74 20 74 68 65 20 77 72 69 74 65 20 76 but the write v
1df0: 65 72 73 69 6f 6e 20 69 73 20 67 72 65 61 74 65 ersion is greate
1e00: 72 20 74 68 61 6e 20 6f 6e 65 2c 20 74 68 65 6e r than one, then
1e10: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 66 69 the database.fi
1e20: 6c 65 20 6d 75 73 74 20 62 65 20 74 72 65 61 74 le must be treat
1e30: 65 64 20 61 73 20 72 65 61 64 2d 6f 6e 6c 79 2e ed as read-only.
1e40: 20 20 49 66 20 61 20 64 61 74 61 62 61 73 65 20 If a database
1e50: 66 69 6c 65 20 77 69 74 68 20 61 20 72 65 61 64 file with a read
1e60: 20 76 65 72 73 69 6f 6e 0a 67 72 65 61 74 65 72 version.greater
1e70: 20 74 68 61 6e 20 31 20 69 73 20 65 6e 63 6f 75 than 1 is encou
1e80: 6e 74 65 72 2c 20 74 68 65 6e 20 74 68 61 74 20 nter, then that
1e90: 64 61 74 61 62 61 73 65 20 63 61 6e 6e 6f 74 20 database cannot
1ea0: 62 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 be read or writt
1eb0: 65 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51 4c 69 en.</p>..<p>SQLi
1ec0: 74 65 20 68 61 73 20 74 68 65 20 61 62 69 6c 69 te has the abili
1ed0: 74 79 20 74 6f 20 73 65 74 20 61 73 69 64 65 20 ty to set aside
1ee0: 61 20 73 6d 61 6c 6c 20 6e 75 6d 62 65 72 20 6f a small number o
1ef0: 66 20 65 78 74 72 61 20 62 79 74 65 73 20 61 74 f extra bytes at
1f00: 0a 74 68 65 20 65 6e 64 20 6f 66 20 65 76 65 72 .the end of ever
1f10: 79 20 70 61 67 65 20 66 6f 72 20 75 73 65 20 62 y page for use b
1f20: 79 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 20 54 y extensions. T
1f30: 68 65 73 65 20 65 78 74 72 61 20 62 79 74 65 73 hese extra bytes
1f40: 20 61 72 65 0a 75 73 65 64 2c 20 66 6f 72 20 65 are.used, for e
1f50: 78 61 6d 70 6c 65 2c 20 62 79 20 74 68 65 20 53 xample, by the S
1f60: 51 4c 69 74 65 20 45 6e 63 72 79 70 74 69 6f 6e QLite Encryption
1f70: 20 45 78 74 65 6e 73 69 6f 6e 20 74 6f 20 73 74 Extension to st
1f80: 6f 72 65 20 61 20 6e 6f 6e 63 65 0a 61 6e 64 2f ore a nonce.and/
1f90: 6f 72 20 63 72 79 70 74 6f 67 72 61 70 68 69 63 or cryptographic
1fa0: 20 63 68 65 63 6b 73 75 6d 20 61 73 73 6f 63 69 checksum associ
1fb0: 61 74 65 64 20 77 69 74 68 20 65 61 63 68 20 70 ated with each p
1fc0: 61 67 65 2e 20 20 54 68 65 20 0a 22 72 65 73 65 age. The ."rese
1fd0: 72 76 65 64 20 73 70 61 63 65 22 20 73 69 7a 65 rved space" size
1fe0: 20 69 6e 20 74 68 65 20 31 2d 62 79 74 65 20 69 in the 1-byte i
1ff0: 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 nteger at offset
2000: 20 32 30 20 69 73 20 74 68 65 20 6e 75 6d 62 65 20 is the numbe
2010: 72 0a 6f 66 20 62 79 74 65 73 20 6f 66 20 73 70 r.of bytes of sp
2020: 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f ace at the end o
2030: 66 20 65 61 63 68 20 70 61 67 65 20 74 6f 20 72 f each page to r
2040: 65 73 65 72 76 65 20 66 6f 72 20 65 78 74 65 6e eserve for exten
2050: 73 69 6f 6e 73 2e 0a 54 68 69 73 20 76 61 6c 75 sions..This valu
2060: 65 20 69 73 20 75 73 75 61 6c 6c 79 20 30 2e 20 e is usually 0.
2070: 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 62 The value can b
2080: 65 20 6f 64 64 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c e odd.</p>..<tcl
2090: 3e 68 64 5f 66 72 61 67 6d 65 6e 74 20 75 73 61 >hd_fragment usa
20a0: 62 6c 65 5f 73 69 7a 65 20 7b 75 73 61 62 6c 65 ble_size {usable
20b0: 20 73 69 7a 65 7d 3c 2f 74 63 6c 3e 0a 3c 70 3e size}</tcl>.<p>
20c0: 54 68 65 20 22 75 73 61 62 6c 65 20 73 69 7a 65 The "usable size
20d0: 22 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 " of a database
20e0: 70 61 67 65 20 69 73 20 74 68 65 20 70 61 67 65 page is the page
20f0: 20 73 69 7a 65 20 73 70 65 63 69 66 79 20 62 79 size specify by
2100: 20 74 68 65 0a 32 2d 62 79 74 65 20 69 6e 74 65 the.2-byte inte
2110: 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 31 36 ger at offset 16
2120: 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 20 6c in the header l
2130: 65 73 73 20 74 68 65 20 22 72 65 73 65 72 76 65 ess the "reserve
2140: 64 22 20 73 70 61 63 65 20 73 69 7a 65 0a 72 65 d" space size.re
2150: 63 6f 72 64 65 64 20 69 6e 20 74 68 65 20 31 2d corded in the 1-
2160: 62 79 74 65 20 69 6e 74 65 67 65 72 20 61 74 20 byte integer at
2170: 6f 66 66 73 65 74 20 32 30 20 69 6e 20 74 68 65 offset 20 in the
2180: 20 68 65 61 64 65 72 2e 20 20 54 68 65 20 75 73 header. The us
2190: 61 62 6c 65 0a 73 69 7a 65 20 6f 66 20 61 20 70 able.size of a p
21a0: 61 67 65 20 6d 69 67 68 74 20 62 65 20 61 6e 20 age might be an
21b0: 6f 64 64 20 6e 75 6d 62 65 72 2e 20 20 48 6f 77 odd number. How
21c0: 65 76 65 72 2c 20 74 68 65 20 75 73 61 62 6c 65 ever, the usable
21d0: 20 73 69 7a 65 20 69 73 20 6e 6f 74 0a 61 6c 6c size is not.all
21e0: 6f 77 65 64 20 74 6f 20 62 65 20 6c 65 73 73 20 owed to be less
21f0: 74 68 61 6e 20 34 38 30 2e 20 20 49 6e 20 6f 74 than 480. In ot
2200: 68 65 72 20 77 6f 72 64 73 2c 20 69 66 20 74 68 her words, if th
2210: 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 20 35 e page size is 5
2220: 31 32 2c 0a 74 68 65 6e 20 74 68 65 20 72 65 73 12,.then the res
2230: 65 72 76 65 64 20 73 70 61 63 65 20 73 69 7a 65 erved space size
2240: 20 63 61 6e 6e 6f 74 20 65 78 63 65 65 64 20 33 cannot exceed 3
2250: 32 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6d 2.</p>..<p>The m
2260: 61 78 69 6d 75 6d 20 61 6e 64 20 6d 69 6e 69 6d aximum and minim
2270: 75 6d 20 65 6d 62 65 64 64 65 64 20 70 61 79 6c um embedded payl
2280: 6f 61 64 20 66 72 61 63 74 69 6f 6e 73 20 61 6e oad fractions an
2290: 64 20 74 68 65 20 6c 65 61 66 0a 70 61 79 6c 6f d the leaf.paylo
22a0: 61 64 20 66 72 61 63 74 69 6f 6e 20 76 61 6c 75 ad fraction valu
22b0: 65 73 20 6d 75 73 74 20 62 65 20 36 34 2c 20 33 es must be 64, 3
22c0: 32 2c 20 61 6e 64 20 33 32 2e 20 20 54 68 65 73 2, and 32. Thes
22d0: 65 20 76 61 6c 75 65 73 20 77 65 72 65 0a 6f 72 e values were.or
22e0: 67 69 6e 61 6c 6c 79 20 69 6e 74 65 6e 64 65 64 ginally intended
22f0: 20 74 6f 20 61 73 20 74 75 6e 61 62 6c 65 20 70 to as tunable p
2300: 61 72 61 6d 65 74 65 72 73 20 74 68 61 74 20 63 arameters that c
2310: 6f 75 6c 64 20 62 65 20 75 73 65 64 20 74 6f 0a ould be used to.
2320: 6d 6f 64 69 66 79 20 74 68 65 20 73 74 6f 72 61 modify the stora
2330: 67 65 20 66 6f 72 6d 61 74 20 6f 66 20 74 68 65 ge format of the
2340: 20 62 2d 74 72 65 65 20 61 6c 67 6f 72 69 74 68 b-tree algorith
2350: 6d 2e 20 20 48 6f 77 65 76 65 72 2c 20 74 68 61 m. However, tha
2360: 74 0a 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 t.functionality
2370: 69 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 64 is not supported
2380: 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20 6e and there are n
2390: 6f 20 63 75 72 72 65 6e 74 20 70 6c 61 6e 73 20 o current plans
23a0: 74 6f 20 61 64 64 0a 73 75 70 70 6f 72 74 20 69 to add.support i
23b0: 6e 20 74 68 65 20 66 75 74 75 72 65 2e 20 20 48 n the future. H
23c0: 65 6e 63 65 2c 20 74 68 65 73 65 20 74 68 72 65 ence, these thre
23d0: 65 20 62 79 74 65 73 20 61 72 65 20 66 69 78 65 e bytes are fixe
23e0: 64 20 61 74 20 74 68 65 0a 76 61 6c 75 65 73 20 d at the.values
23f0: 73 70 65 63 69 66 69 65 64 2e 3c 2f 70 3e 0a 0a specified.</p>..
2400: 3c 70 3e 54 68 65 20 66 69 6c 65 20 63 68 61 6e <p>The file chan
2410: 67 65 20 63 6f 75 6e 74 65 72 20 69 73 20 61 20 ge counter is a
2420: 34 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 4-byte big-endia
2430: 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 n integer which
2440: 69 73 0a 69 6e 63 72 65 6d 65 6e 74 65 64 20 77 is.incremented w
2450: 68 65 6e 65 76 65 72 20 74 68 65 20 64 61 74 61 henever the data
2460: 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 68 61 base file is cha
2470: 6e 67 65 64 2e 20 20 57 68 65 6e 20 74 77 6f 20 nged. When two
2480: 6f 72 20 6d 6f 72 65 0a 70 72 6f 63 65 73 73 65 or more.processe
2490: 73 20 61 72 65 20 72 65 61 64 69 6e 67 20 74 68 s are reading th
24a0: 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 e same database
24b0: 66 69 6c 65 2c 20 65 61 63 68 20 70 72 6f 63 65 file, each proce
24c0: 73 73 20 63 61 6e 20 64 65 74 65 63 74 0a 64 61 ss can detect.da
24d0: 74 61 62 61 73 65 20 63 68 61 6e 67 65 73 20 66 tabase changes f
24e0: 72 6f 6d 20 6f 74 68 65 72 20 70 72 6f 63 65 73 rom other proces
24f0: 73 65 73 20 62 79 20 6d 6f 6e 69 74 6f 72 69 6e ses by monitorin
2500: 67 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f 75 g the change cou
2510: 6e 74 65 72 2e 0a 41 20 70 72 6f 63 65 73 73 20 nter..A process
2520: 77 69 6c 6c 20 6e 6f 72 6d 61 6c 6c 79 20 77 61 will normally wa
2530: 6e 74 20 74 6f 20 66 6c 75 73 68 20 69 74 73 20 nt to flush its
2540: 64 61 74 61 62 61 73 65 20 70 61 67 65 20 63 61 database page ca
2550: 63 68 65 20 77 68 65 6e 0a 61 6e 6f 74 68 65 72 che when.another
2560: 20 70 72 6f 63 65 73 73 20 6d 6f 64 69 66 69 65 process modifie
2570: 64 20 74 68 65 20 64 61 74 61 62 61 73 65 2c 20 d the database,
2580: 73 69 6e 63 65 20 74 68 65 20 63 61 63 68 65 20 since the cache
2590: 68 61 73 20 62 65 63 6f 6d 65 20 73 74 61 6c 65 has become stale
25a0: 2e 0a 54 68 65 20 66 69 6c 65 20 63 68 61 6e 67 ..The file chang
25b0: 65 20 63 6f 75 6e 74 65 72 20 66 61 63 69 6c 69 e counter facili
25c0: 74 61 74 65 73 20 74 68 69 73 2e 3c 2f 70 3e 0a tates this.</p>.
25d0: 0a 3c 70 3e 55 6e 75 73 65 64 20 70 61 67 65 73 .<p>Unused pages
25e0: 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
25f0: 20 66 69 6c 65 20 61 72 65 20 73 74 6f 72 65 64 file are stored
2600: 20 6f 6e 20 61 20 66 72 65 65 6c 69 73 74 2e 20 on a freelist.
2610: 20 54 68 65 0a 34 2d 62 79 74 65 20 62 69 67 2d The.4-byte big-
2620: 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 61 endian integer a
2630: 74 20 6f 66 66 73 65 74 20 33 32 20 73 74 6f 72 t offset 32 stor
2640: 65 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 es the page numb
2650: 65 72 20 6f 66 0a 74 68 65 20 66 69 72 73 74 20 er of.the first
2660: 70 61 67 65 20 6f 66 20 74 68 65 20 66 72 65 65 page of the free
2670: 6c 69 73 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 list, or zero if
2680: 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 the freelist is
2690: 20 65 6d 70 74 79 2e 0a 54 68 65 20 34 2d 62 79 empty..The 4-by
26a0: 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e te big-endian in
26b0: 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
26c0: 33 36 20 73 74 6f 72 65 73 20 73 74 6f 72 65 73 36 stores stores
26d0: 20 74 68 65 20 74 6f 74 61 6c 20 0a 6e 75 6d 62 the total .numb
26e0: 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 er of pages on t
26f0: 68 65 20 66 72 65 65 6c 69 73 74 2e 3c 2f 70 3e he freelist.</p>
2700: 0a 0a 3c 70 3e 54 68 65 20 73 63 68 65 6d 61 20 ..<p>The schema
2710: 63 6f 6f 6b 69 65 20 69 73 20 61 20 34 2d 62 79 cookie is a 4-by
2720: 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e te big-endian in
2730: 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
2740: 34 30 0a 74 68 61 74 20 69 73 20 69 6e 63 72 65 40.that is incre
2750: 6d 65 6e 74 65 64 20 77 68 65 6e 65 76 65 72 20 mented whenever
2760: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 the database sch
2770: 65 6d 61 20 63 68 61 6e 67 65 73 2e 20 20 41 20 ema changes. A
2780: 0a 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d .prepared statem
2790: 65 6e 74 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 ent is compiled
27a0: 61 67 61 69 6e 73 74 20 61 20 73 70 65 63 69 66 against a specif
27b0: 69 63 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 ic version of th
27c0: 65 0a 64 61 74 61 62 61 73 65 20 73 63 68 65 6d e.database schem
27d0: 61 2e 20 20 57 68 65 6e 65 76 65 72 20 74 68 65 a. Whenever the
27e0: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
27f0: 20 63 68 61 6e 67 65 73 2c 20 74 68 65 20 73 74 changes, the st
2800: 61 74 65 6d 65 6e 74 0a 6d 75 73 74 20 62 65 20 atement.must be
2810: 72 65 70 72 65 70 61 72 65 64 2e 20 20 57 68 65 reprepared. Whe
2820: 6e 65 76 65 72 20 61 20 70 72 65 70 61 72 65 64 never a prepared
2830: 20 73 74 61 74 65 6d 65 6e 74 20 72 75 6e 73 2c statement runs,
2840: 20 69 74 20 66 69 72 73 74 20 63 68 65 63 6b 73 it first checks
2850: 0a 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b .the schema cook
2860: 69 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 ie to make sure
2870: 74 68 65 20 76 61 6c 75 65 20 69 73 20 74 68 65 the value is the
2880: 20 73 61 6d 65 20 61 73 20 77 68 65 6e 20 74 68 same as when th
2890: 65 20 73 74 61 74 65 6d 65 6e 74 0a 77 61 73 20 e statement.was
28a0: 70 72 65 70 61 72 65 64 20 61 6e 64 20 69 66 20 prepared and if
28b0: 6e 6f 74 20 69 74 20 61 62 6f 72 74 73 20 74 6f not it aborts to
28c0: 20 66 6f 72 63 65 20 74 68 65 20 73 74 61 74 65 force the state
28d0: 6d 65 6e 74 20 74 6f 20 62 65 20 72 65 70 72 65 ment to be repre
28e0: 70 61 72 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 pared.</p>..<p>T
28f0: 68 65 20 73 63 68 65 6d 61 20 66 6f 72 6d 61 74 he schema format
2900: 20 6e 75 6d 62 65 72 20 69 73 20 61 20 34 2d 62 number is a 4-b
2910: 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 yte big-endian i
2920: 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 nteger at offset
2930: 20 34 34 2e 0a 54 68 65 20 73 63 68 65 6d 61 20 44..The schema
2940: 66 6f 72 6d 61 74 20 6e 75 6d 62 65 72 20 69 73 format number is
2950: 20 73 69 6d 69 6c 61 72 20 74 6f 20 74 68 65 20 similar to the
2960: 66 69 6c 65 20 66 6f 72 6d 61 74 20 72 65 61 64 file format read
2970: 20 61 6e 64 20 77 72 69 74 65 0a 76 65 72 73 69 and write.versi
2980: 6f 6e 20 6e 75 6d 62 65 72 73 20 61 74 20 6f 66 on numbers at of
2990: 66 73 65 74 73 20 31 38 20 61 6e 64 20 31 39 20 fsets 18 and 19
29a0: 65 78 63 65 70 74 20 74 68 61 74 20 74 68 65 20 except that the
29b0: 73 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 6e 75 schema format nu
29c0: 6d 62 65 72 0a 72 65 66 65 72 73 20 74 6f 20 74 mber.refers to t
29d0: 68 65 20 68 69 67 68 2d 6c 65 76 65 6c 20 53 51 he high-level SQ
29e0: 4c 20 66 6f 72 6d 61 74 74 69 6e 67 20 72 61 74 L formatting rat
29f0: 68 65 72 20 74 68 61 6e 20 74 68 65 20 6c 6f 77 her than the low
2a00: 2d 6c 65 76 65 6c 20 62 2d 74 72 65 65 0a 66 6f -level b-tree.fo
2a10: 72 6d 61 74 74 69 6e 67 2e 20 20 46 6f 75 72 20 rmatting. Four
2a20: 73 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 6e 75 schema format nu
2a30: 6d 62 65 72 73 20 61 72 65 20 63 75 72 72 65 6e mbers are curren
2a40: 74 6c 79 20 64 65 66 69 6e 65 64 3a 3c 2f 70 3e tly defined:</p>
2a50: 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75 65 ..<ol>.<li value
2a60: 3d 31 3e 46 6f 72 6d 61 74 20 31 20 69 73 20 75 =1>Format 1 is u
2a70: 6e 64 65 72 73 74 6f 6f 64 20 62 79 20 61 6c 6c nderstood by all
2a80: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
2a90: 69 74 65 20 62 61 63 6b 20 74 6f 0a 76 65 72 73 ite back to.vers
2aa0: 69 6f 6e 20 33 2e 30 2e 30 2e 3c 2f 6c 69 3e 0a ion 3.0.0.</li>.
2ab0: 3c 6c 69 20 76 61 6c 75 65 3d 32 3e 46 6f 72 6d <li value=2>Form
2ac0: 61 74 20 32 20 61 64 64 73 20 74 68 65 20 61 62 at 2 adds the ab
2ad0: 69 6c 69 74 79 20 6f 66 20 72 6f 77 73 20 77 69 ility of rows wi
2ae0: 74 68 69 6e 20 74 68 65 20 73 61 6d 65 20 74 61 thin the same ta
2af0: 62 6c 65 0a 74 6f 20 68 61 76 65 20 61 20 76 61 ble.to have a va
2b00: 72 69 6e 67 20 6e 75 6d 62 65 72 20 6f 66 20 63 ring number of c
2b10: 6f 6c 75 6d 6e 73 2c 20 69 6e 20 6f 72 64 65 72 olumns, in order
2b20: 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 0a to support the.
2b30: 5b 41 4c 54 45 52 20 54 41 42 4c 45 20 7c 20 41 [ALTER TABLE | A
2b40: 4c 54 45 52 20 54 41 42 4c 45 20 2e 2e 2e 20 41 LTER TABLE ... A
2b50: 44 44 20 43 4f 4c 55 4d 4e 5d 20 66 75 6e 63 74 DD COLUMN] funct
2b60: 69 6f 6e 61 6c 69 74 79 2e 20 20 53 75 70 70 6f ionality. Suppo
2b70: 72 74 20 66 6f 72 0a 72 65 61 64 69 6e 67 20 61 rt for.reading a
2b80: 6e 64 20 77 72 69 74 69 6e 67 20 66 6f 72 6d 61 nd writing forma
2b90: 74 20 32 20 77 61 73 20 61 64 64 65 64 20 69 6e t 2 was added in
2ba0: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 SQLite version
2bb0: 33 2e 31 2e 33 20 0a 6f 6e 20 32 30 30 35 2d 30 3.1.3 .on 2005-0
2bc0: 32 2d 31 39 2e 3c 2f 6c 69 3e 0a 3c 6c 69 20 76 2-19.</li>.<li v
2bd0: 61 6c 75 65 3d 33 3e 46 6f 72 6d 61 74 20 33 20 alue=3>Format 3
2be0: 61 64 64 73 20 74 68 65 20 61 62 69 6c 69 74 79 adds the ability
2bf0: 20 6f 66 20 65 78 74 72 61 20 63 6f 6c 75 6d 6e of extra column
2c00: 73 20 61 64 64 65 64 20 62 79 0a 5b 41 4c 54 45 s added by.[ALTE
2c10: 52 20 54 41 42 4c 45 20 7c 20 41 4c 54 45 52 20 R TABLE | ALTER
2c20: 54 41 42 4c 45 20 2e 2e 2e 20 41 44 44 20 43 4f TABLE ... ADD CO
2c30: 4c 55 4d 4e 5d 20 74 6f 20 68 61 76 65 20 6e 6f LUMN] to have no
2c40: 6e 2d 4e 55 4c 4c 20 64 65 66 61 75 6c 74 0a 76 n-NULL default.v
2c50: 61 6c 75 65 73 2e 20 20 54 68 69 73 20 63 61 70 alues. This cap
2c60: 61 62 69 6c 69 74 79 20 77 61 73 20 61 64 64 65 ability was adde
2c70: 64 20 69 6e 20 53 51 4c 69 74 65 20 76 65 72 73 d in SQLite vers
2c80: 69 6f 6e 20 33 2e 31 2e 34 20 0a 6f 6e 20 32 30 ion 3.1.4 .on 20
2c90: 30 35 2d 30 33 2d 31 31 2e 3c 2f 6c 69 3e 0a 3c 05-03-11.</li>.<
2ca0: 6c 69 20 76 61 6c 75 65 3d 34 3e 46 6f 72 6d 61 li value=4>Forma
2cb0: 74 20 34 20 63 61 75 73 65 73 20 53 51 4c 69 74 t 4 causes SQLit
2cc0: 65 20 74 6f 20 72 65 73 70 65 63 74 20 74 68 65 e to respect the
2cd0: 20 44 45 53 43 20 6b 65 79 77 6f 72 64 20 6f 6e DESC keyword on
2ce0: 0a 69 6e 64 65 78 20 64 65 63 6c 61 72 61 74 69 .index declarati
2cf0: 6f 6e 73 2e 20 20 28 54 68 65 20 44 45 53 43 20 ons. (The DESC
2d00: 6b 65 79 77 6f 72 64 20 69 73 20 69 67 6e 6f 72 keyword is ignor
2d10: 65 64 20 69 6e 20 69 6e 64 69 63 65 73 20 66 6f ed in indices fo
2d20: 72 20 0a 66 6f 72 6d 61 74 73 20 31 2c 20 32 2c r .formats 1, 2,
2d30: 20 61 6e 64 20 33 2e 29 0a 46 6f 72 6d 61 74 20 and 3.).Format
2d40: 34 20 61 6c 73 6f 20 61 64 64 73 20 74 77 6f 20 4 also adds two
2d50: 6e 65 77 20 62 6f 6f 6c 65 61 6e 20 72 65 63 6f new boolean reco
2d60: 72 64 20 74 79 70 65 20 76 61 6c 75 65 73 20 28 rd type values (
2d70: 5b 73 65 72 69 61 6c 20 74 79 70 65 73 5d 0a 38 [serial types].8
2d80: 20 61 6e 64 20 39 2e 29 20 20 53 75 70 70 6f 72 and 9.) Suppor
2d90: 74 20 66 6f 72 20 66 6f 72 6d 61 74 20 34 20 77 t for format 4 w
2da0: 61 73 20 61 64 64 65 64 20 69 6e 20 53 51 4c 69 as added in SQLi
2db0: 74 65 20 33 2e 33 2e 30 20 6f 6e 0a 32 30 30 36 te 3.3.0 on.2006
2dc0: 2d 30 31 2d 31 30 2e 3c 2f 6c 69 3e 0a 3c 2f 6f -01-10.</li>.</o
2dd0: 6c 3e 0a 0a 3c 70 3e 4e 65 77 20 64 61 74 61 62 l>..<p>New datab
2de0: 61 73 65 20 66 69 6c 65 73 20 63 72 65 61 74 65 ase files create
2df0: 64 20 62 79 20 53 51 4c 69 74 65 20 75 73 65 20 d by SQLite use
2e00: 66 6f 72 6d 61 74 20 31 20 62 79 20 64 65 66 61 format 1 by defa
2e10: 75 6c 74 2c 20 73 6f 0a 74 68 61 74 20 64 61 74 ult, so.that dat
2e20: 61 62 61 73 65 20 66 69 6c 65 73 20 63 72 65 61 abase files crea
2e30: 74 65 64 20 62 79 20 6e 65 77 65 72 20 76 65 72 ted by newer ver
2e40: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 sions of SQLite
2e50: 63 61 6e 20 73 74 69 6c 6c 0a 62 65 20 72 65 61 can still.be rea
2e60: 64 20 62 79 20 6f 6c 64 65 72 20 76 65 72 73 69 d by older versi
2e70: 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2e 0a 54 ons of SQLite..T
2e80: 68 65 20 5b 6c 65 67 61 63 79 5f 66 69 6c 65 5f he [legacy_file_
2e90: 66 6f 72 6d 61 74 20 70 72 61 67 6d 61 5d 20 63 format pragma] c
2ea0: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 61 an be used to ca
2eb0: 75 73 65 20 53 51 4c 69 74 65 0a 74 6f 20 63 72 use SQLite.to cr
2ec0: 65 61 74 65 20 6e 65 77 20 64 61 74 61 62 61 73 eate new databas
2ed0: 65 20 66 69 6c 65 73 20 75 73 69 6e 67 20 66 6f e files using fo
2ee0: 72 6d 61 74 20 34 2e 20 20 46 75 74 75 72 65 20 rmat 4. Future
2ef0: 76 65 72 73 69 6f 6e 73 20 6f 66 20 0a 53 51 4c versions of .SQL
2f00: 69 74 65 20 6d 61 79 20 62 65 67 69 6e 20 74 6f ite may begin to
2f10: 20 63 72 65 61 74 65 20 66 69 6c 65 73 20 75 73 create files us
2f20: 69 6e 67 20 66 6f 72 6d 61 74 20 34 20 62 79 20 ing format 4 by
2f30: 64 65 66 61 75 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70 default.</p>..<p
2f40: 3e 54 68 65 20 34 2d 62 79 74 65 20 62 69 67 2d >The 4-byte big-
2f50: 65 6e 64 69 61 6e 20 73 69 67 6e 65 64 20 69 6e endian signed in
2f60: 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
2f70: 34 38 20 69 73 20 74 68 65 20 73 75 67 67 65 73 48 is the sugges
2f80: 74 0a 63 61 63 68 65 20 73 69 7a 65 20 69 6e 20 t.cache size in
2f90: 70 61 67 65 73 20 66 6f 72 20 74 68 65 20 64 61 pages for the da
2fa0: 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 54 68 tabase file. Th
2fb0: 65 20 76 61 6c 75 65 20 69 73 20 61 20 73 75 67 e value is a sug
2fc0: 67 65 73 74 69 6f 6e 0a 6f 6e 6c 79 20 61 6e 64 gestion.only and
2fd0: 20 53 51 4c 69 74 65 20 69 73 20 75 6e 64 65 72 SQLite is under
2fe0: 20 6e 6f 20 6f 62 6c 69 67 61 74 69 6f 6e 20 74 no obligation t
2ff0: 6f 20 68 6f 6e 6f 72 20 69 74 2e 20 20 54 68 65 o honor it. The
3000: 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75 65 0a absolute value.
3010: 6f 66 20 74 68 65 20 69 6e 74 65 67 65 72 20 69 of the integer i
3020: 73 20 75 73 65 64 20 61 73 20 74 68 65 20 73 75 s used as the su
3030: 67 67 65 73 74 65 64 20 73 69 7a 65 2e 20 20 54 ggested size. T
3040: 68 65 20 73 75 67 67 65 73 74 65 64 20 63 61 63 he suggested cac
3050: 68 65 20 73 69 7a 65 0a 63 61 6e 20 62 65 20 73 he size.can be s
3060: 65 74 20 75 73 69 6e 67 20 74 68 65 20 5b 64 65 et using the [de
3070: 66 61 75 6c 74 5f 63 61 63 68 65 5f 73 69 7a 65 fault_cache_size
3080: 20 70 72 61 67 6d 61 5d 2e 3c 2f 70 3e 0a 0a 3c pragma].</p>..<
3090: 70 3e 54 68 65 20 74 77 6f 20 34 2d 62 79 74 65 p>The two 4-byte
30a0: 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 big-endian inte
30b0: 67 65 72 73 20 61 74 20 6f 66 66 73 65 74 73 20 gers at offsets
30c0: 35 32 20 61 6e 64 20 36 34 20 61 72 65 20 75 73 52 and 64 are us
30d0: 65 64 0a 74 6f 20 6d 61 6e 61 67 65 20 74 68 65 ed.to manage the
30e0: 20 5b 61 75 74 6f 5f 76 61 63 75 75 6d 5d 20 61 [auto_vacuum] a
30f0: 6e 64 20 5b 69 6e 63 72 65 6d 65 6e 74 61 6c 5f nd [incremental_
3100: 76 61 63 75 75 6d 5d 20 6d 6f 64 65 73 2e 20 20 vacuum] modes.
3110: 49 66 0a 74 68 65 20 69 6e 74 65 67 65 72 20 61 If.the integer a
3120: 74 20 6f 66 66 73 65 74 20 35 32 20 69 73 20 7a t offset 52 is z
3130: 65 72 6f 20 74 68 65 6e 20 70 6f 69 6e 74 65 72 ero then pointer
3140: 2d 6d 61 70 20 28 70 74 72 6d 61 70 29 20 70 61 -map (ptrmap) pa
3150: 67 65 73 20 61 72 65 0a 6f 6d 69 74 74 65 64 20 ges are.omitted
3160: 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
3170: 65 20 66 69 6c 65 20 61 6e 64 20 6e 65 69 74 68 e file and neith
3180: 65 72 20 61 75 74 6f 5f 76 61 63 75 75 6d 20 6e er auto_vacuum n
3190: 6f 72 0a 69 6e 63 72 65 6d 65 6e 74 61 6c 5f 76 or.incremental_v
31a0: 61 63 75 75 6d 20 61 72 65 20 73 75 70 70 6f 72 acuum are suppor
31b0: 74 65 64 2e 20 20 49 66 20 74 68 65 20 69 6e 74 ted. If the int
31c0: 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 35 eger at offset 5
31d0: 32 20 69 73 0a 6e 6f 6e 2d 7a 65 72 6f 20 74 68 2 is.non-zero th
31e0: 65 6e 20 69 74 20 69 73 20 74 68 65 20 70 61 67 en it is the pag
31f0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
3200: 6c 61 72 67 65 73 74 20 72 6f 6f 74 20 70 61 67 largest root pag
3210: 65 20 69 6e 20 74 68 65 0a 64 61 74 61 62 61 73 e in the.databas
3220: 65 20 66 69 6c 65 2c 20 74 68 65 20 64 61 74 61 e file, the data
3230: 62 61 73 65 20 66 69 6c 65 20 63 6f 6e 74 61 69 base file contai
3240: 6e 20 70 74 72 6d 61 70 20 70 61 67 65 73 2c 20 n ptrmap pages,
3250: 61 6e 64 20 74 68 65 0a 6d 6f 64 65 20 6d 75 73 and the.mode mus
3260: 74 20 62 65 20 65 69 74 68 65 72 20 61 75 74 6f t be either auto
3270: 5f 76 61 63 75 75 6d 20 6f 72 20 69 6e 63 72 65 _vacuum or incre
3280: 6d 65 6e 74 61 6c 5f 76 61 63 75 75 6d 2e 20 20 mental_vacuum.
3290: 49 6e 20 74 68 69 73 20 6c 61 74 74 65 72 0a 63 In this latter.c
32a0: 61 73 65 2c 20 74 68 65 20 69 6e 74 65 67 65 72 ase, the integer
32b0: 20 61 74 20 6f 66 66 73 65 74 20 36 34 20 69 73 at offset 64 is
32c0: 20 74 72 75 65 20 66 6f 72 20 69 6e 63 72 65 6d true for increm
32d0: 65 6e 74 61 6c 5f 76 61 63 75 75 6d 20 61 6e 64 ental_vacuum and
32e0: 0a 66 61 6c 73 65 20 66 6f 72 20 61 75 74 6f 5f .false for auto_
32f0: 76 61 63 75 75 6d 2e 20 20 49 66 20 74 68 65 20 vacuum. If the
3300: 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 integer at offse
3310: 74 20 35 32 20 69 73 20 7a 65 72 6f 20 74 68 65 t 52 is zero the
3320: 6e 0a 74 68 65 20 69 6e 74 65 67 65 72 20 61 74 n.the integer at
3330: 20 6f 66 66 73 65 74 20 36 34 20 6d 75 73 74 20 offset 64 must
3340: 61 6c 73 6f 20 62 65 20 7a 65 72 6f 2e 3c 2f 70 also be zero.</p
3350: 3e 0a 0a 3c 70 3e 54 68 65 20 34 2d 62 79 74 65 >..<p>The 4-byte
3360: 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 big-endian inte
3370: 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 35 36 ger at offset 56
3380: 20 64 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 determines the
3390: 65 6e 63 6f 64 69 6e 67 0a 75 73 65 64 20 66 6f encoding.used fo
33a0: 72 20 61 6c 6c 20 74 65 78 74 20 73 74 72 69 6e r all text strin
33b0: 67 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 gs stored in the
33c0: 20 64 61 74 61 62 61 73 65 2e 20 20 41 20 76 61 database. A va
33d0: 6c 75 65 20 6f 66 20 31 20 6d 65 61 6e 73 0a 55 lue of 1 means.U
33e0: 54 46 2d 38 2e 20 20 41 20 76 61 6c 75 65 20 6f TF-8. A value o
33f0: 66 20 32 20 6d 65 61 6e 73 20 55 54 46 2d 31 36 f 2 means UTF-16
3400: 6c 65 2e 20 20 41 20 76 61 6c 75 65 20 6f 66 20 le. A value of
3410: 33 20 6d 65 61 6e 73 20 55 54 46 2d 31 36 62 65 3 means UTF-16be
3420: 2e 0a 4e 6f 20 6f 74 68 65 72 20 76 61 6c 75 65 ..No other value
3430: 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 3c 2f s are allowed.</
3440: 70 3e 0a 0a 3c 70 3e 54 68 65 20 34 2d 62 79 74 p>..<p>The 4-byt
3450: 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 e big-endian int
3460: 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 36 eger at offset 6
3470: 30 20 69 73 20 74 68 65 20 75 73 65 72 20 76 65 0 is the user ve
3480: 72 73 69 6f 6e 20 77 68 69 63 68 0a 69 73 20 73 rsion which.is s
3490: 65 74 20 61 6e 64 20 71 75 65 72 69 65 64 20 62 et and queried b
34a0: 79 20 74 68 65 20 5b 75 73 65 72 5f 76 65 72 73 y the [user_vers
34b0: 69 6f 6e 20 70 72 61 67 6d 61 5d 2e 20 20 54 68 ion pragma]. Th
34c0: 65 20 75 73 65 72 20 76 65 72 73 69 6f 6e 20 69 e user version i
34d0: 73 0a 6e 6f 74 20 75 73 65 64 20 62 79 20 53 51 s.not used by SQ
34e0: 4c 69 74 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 6c Lite.</p>..<p>Al
34f0: 6c 20 6f 74 68 65 72 20 62 79 74 65 73 20 6f 66 l other bytes of
3500: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
3510: 6c 65 20 68 65 61 64 65 72 20 61 72 65 20 72 65 le header are re
3520: 73 65 72 76 65 64 20 66 6f 72 0a 66 75 74 75 72 served for.futur
3530: 65 20 65 78 70 61 6e 73 69 6f 6e 20 61 6e 64 20 e expansion and
3540: 6d 75 73 74 20 62 65 20 73 65 74 20 74 6f 20 7a must be set to z
3550: 65 72 6f 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 31 2e ero.</p>..<h3>1.
3560: 33 20 54 68 65 20 4c 6f 63 6b 2d 42 79 74 65 20 3 The Lock-Byte
3570: 50 61 67 65 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 Page</h3>..<p>Th
3580: 65 20 6c 6f 63 6b 2d 62 79 74 65 20 70 61 67 65 e lock-byte page
3590: 20 69 73 20 74 68 65 20 73 69 6e 67 6c 65 20 70 is the single p
35a0: 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 age of the datab
35b0: 61 73 65 20 66 69 6c 65 0a 74 68 61 74 20 63 6f ase file.that co
35c0: 6e 74 61 69 6e 73 20 74 68 65 20 62 79 74 65 73 ntains the bytes
35d0: 20 61 74 20 6f 66 66 73 65 74 73 20 62 65 74 77 at offsets betw
35e0: 65 65 6e 20 31 30 37 33 37 34 31 38 32 34 20 61 een 1073741824 a
35f0: 6e 64 20 31 30 37 33 37 34 32 33 33 35 2c 0a 69 nd 1073742335,.i
3600: 6e 63 6c 75 73 69 76 65 2e 20 20 41 20 64 61 74 nclusive. A dat
3610: 61 62 61 73 65 20 66 69 6c 65 20 74 68 61 74 20 abase file that
3620: 69 73 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 is less than or
3630: 65 71 75 61 6c 20 74 6f 20 31 30 37 33 37 34 31 equal to 1073741
3640: 38 32 34 20 62 79 74 65 73 20 0a 69 6e 20 73 69 824 bytes .in si
3650: 7a 65 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 6c ze contains no l
3660: 6f 63 6b 2d 62 79 74 65 20 70 61 67 65 2e 20 20 ock-byte page.
3670: 41 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 A database file
3680: 6c 61 72 67 65 72 20 74 68 61 6e 0a 31 30 37 33 larger than.1073
3690: 37 34 31 38 32 34 20 63 6f 6e 74 61 69 6e 73 20 741824 contains
36a0: 65 78 61 63 74 6c 79 20 6f 6e 65 20 6c 6f 63 6b exactly one lock
36b0: 2d 62 79 74 65 20 70 61 67 65 2e 0a 3c 2f 70 3e -byte page..</p>
36c0: 0a 0a 3c 70 3e 54 68 65 20 6c 6f 63 6b 2d 62 79 ..<p>The lock-by
36d0: 74 65 20 70 61 67 65 20 69 73 20 73 65 74 20 61 te page is set a
36e0: 73 69 64 65 20 66 6f 72 20 75 73 65 20 62 79 20 side for use by
36f0: 74 68 65 20 6f 70 65 72 61 74 69 6e 67 2d 73 79 the operating-sy
3700: 73 74 65 6d 20 73 70 65 63 69 66 69 63 0a 56 46 stem specific.VF
3710: 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e S implementation
3720: 20 69 6e 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 in implementing
3730: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
3740: 6c 65 20 6c 6f 63 6b 69 6e 67 20 70 72 69 6d 69 le locking primi
3750: 74 69 76 65 73 2e 0a 53 51 4c 69 74 65 20 77 69 tives..SQLite wi
3760: 6c 6c 20 6e 6f 74 20 75 73 65 20 74 68 65 20 6c ll not use the l
3770: 6f 63 6b 2d 62 79 74 65 20 70 61 67 65 3b 20 69 ock-byte page; i
3780: 74 20 77 69 6c 6c 20 6e 65 76 65 72 20 62 65 20 t will never be
3790: 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 0a read or written.
37a0: 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f by the SQLite co
37b0: 72 65 2c 20 74 68 6f 75 67 68 20 6f 70 65 72 61 re, though opera
37c0: 74 69 6e 67 2d 73 79 73 74 65 6d 20 73 70 65 63 ting-system spec
37d0: 69 66 69 63 20 56 46 53 20 69 6d 70 6c 65 6d 65 ific VFS impleme
37e0: 6e 74 69 6f 6e 73 20 6d 61 79 0a 63 68 6f 6f 73 ntions may.choos
37f0: 65 20 74 6f 20 72 65 61 64 20 6f 72 20 77 72 69 e to read or wri
3800: 74 65 20 62 79 74 65 73 20 6f 6e 20 74 68 65 20 te bytes on the
3810: 6c 6f 63 6b 2d 62 79 74 65 20 70 61 67 65 20 61 lock-byte page a
3820: 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 ccording to the
3830: 0a 6e 65 65 64 73 20 61 6e 64 20 70 72 6f 63 6c .needs and procl
3840: 61 76 69 74 69 65 73 20 6f 66 20 74 68 65 20 75 avities of the u
3850: 6e 64 65 72 6c 79 69 6e 67 20 73 79 73 74 65 6d nderlying system
3860: 2e 20 20 54 68 65 20 75 6e 69 78 20 61 6e 64 20 . The unix and
3870: 77 69 6e 33 32 0a 56 46 53 20 69 6d 70 6c 65 6d win32.VFS implem
3880: 65 6e 74 61 74 69 6f 6e 73 20 74 68 61 74 20 63 entations that c
3890: 6f 6d 65 20 62 75 69 6c 74 20 69 6e 74 6f 20 53 ome built into S
38a0: 51 4c 69 74 65 20 64 6f 20 6e 6f 74 20 77 72 69 QLite do not wri
38b0: 74 65 20 74 6f 20 74 68 65 0a 6c 6f 63 6b 2d 62 te to the.lock-b
38c0: 79 74 65 20 70 61 67 65 2c 20 62 75 74 20 77 65 yte page, but we
38d0: 20 61 72 65 20 61 77 61 72 65 20 6f 66 20 74 68 are aware of th
38e0: 69 72 64 2d 70 61 72 74 79 20 56 46 53 20 69 6d ird-party VFS im
38f0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 66 6f plementations fo
3900: 72 0a 6f 74 68 65 72 20 6f 70 65 72 61 74 69 6e r.other operatin
3910: 67 20 73 79 73 74 65 6d 73 20 74 68 61 74 20 64 g systems that d
3920: 6f 20 73 6f 6d 65 74 69 6d 65 73 20 77 72 69 74 o sometimes writ
3930: 65 20 74 6f 20 74 68 65 20 6c 6f 63 6b 2d 62 79 e to the lock-by
3940: 74 65 20 70 61 67 65 2e 3c 2f 70 3e 0a 0a 3c 68 te page.</p>..<h
3950: 33 3e 31 2e 34 20 54 68 65 20 46 72 65 65 6c 69 3>1.4 The Freeli
3960: 73 74 3c 2f 68 33 3e 0a 0a 3c 70 3e 41 20 64 61 st</h3>..<p>A da
3970: 74 61 62 61 73 65 20 66 69 6c 65 20 6d 69 67 68 tabase file migh
3980: 74 20 63 6f 6e 74 61 69 6e 20 6f 6e 65 20 6f 72 t contain one or
3990: 20 6d 6f 72 65 20 70 61 67 65 73 20 74 68 61 74 more pages that
39a0: 20 61 72 65 20 6e 6f 74 20 69 6e 0a 61 63 74 69 are not in.acti
39b0: 76 65 20 75 73 65 2e 20 20 55 6e 75 73 65 64 20 ve use. Unused
39c0: 70 61 67 65 73 20 63 61 6e 20 63 6f 6d 65 20 61 pages can come a
39d0: 62 6f 75 74 2c 20 66 6f 72 20 65 78 61 6d 70 6c bout, for exampl
39e0: 65 2c 20 77 68 65 6e 20 69 6e 66 6f 72 6d 61 74 e, when informat
39f0: 69 6f 6e 0a 69 73 20 64 65 6c 65 74 65 64 20 66 ion.is deleted f
3a00: 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
3a10: 2e 20 20 55 6e 75 73 65 64 20 70 61 67 65 73 20 . Unused pages
3a20: 61 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 74 68 are stored on th
3a30: 65 20 66 72 65 65 6c 69 73 74 0a 61 6e 64 20 61 e freelist.and a
3a40: 72 65 20 72 65 75 73 65 64 20 77 68 65 6e 20 61 re reused when a
3a50: 64 64 69 74 69 6f 6e 61 6c 20 70 61 67 65 73 20 dditional pages
3a60: 61 72 65 20 72 65 71 75 69 72 65 64 2e 3c 2f 70 are required.</p
3a70: 3e 0a 0a 3c 70 3e 54 68 65 20 66 72 65 65 6c 69 >..<p>The freeli
3a80: 73 74 20 69 73 20 6f 72 67 61 6e 69 7a 65 64 20 st is organized
3a90: 61 73 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 as a linked list
3aa0: 20 6f 66 20 66 72 65 65 6c 69 73 74 20 74 72 75 of freelist tru
3ab0: 6e 6b 20 70 61 67 65 73 0a 77 69 74 68 20 65 61 nk pages.with ea
3ac0: 63 68 20 74 72 75 6e 6b 20 70 61 67 65 73 20 63 ch trunk pages c
3ad0: 6f 6e 74 61 69 6e 69 6e 67 20 70 61 67 65 20 6e ontaining page n
3ae0: 75 6d 62 65 72 73 20 66 6f 72 20 7a 65 72 6f 20 umbers for zero
3af0: 6f 72 20 6d 6f 72 65 20 66 72 65 65 6c 69 73 74 or more freelist
3b00: 0a 6c 65 61 66 20 70 61 67 65 73 2e 3c 2f 70 3e .leaf pages.</p>
3b10: 0a 0a 3c 70 3e 41 20 66 72 65 65 6c 69 73 74 20 ..<p>A freelist
3b20: 74 72 75 6e 6b 20 70 61 67 65 20 63 6f 6e 73 69 trunk page consi
3b30: 73 74 73 20 6f 66 20 61 6e 20 61 72 72 61 79 20 sts of an array
3b40: 6f 66 20 34 2d 62 79 74 65 20 62 69 67 2d 65 6e of 4-byte big-en
3b50: 64 69 61 6e 20 69 6e 74 65 67 65 72 73 2e 0a 54 dian integers..T
3b60: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 61 he size of the a
3b70: 72 72 61 79 20 69 73 20 61 73 20 6d 61 6e 79 20 rray is as many
3b80: 69 6e 74 65 67 65 72 73 20 61 73 20 77 69 6c 6c integers as will
3b90: 20 66 69 74 20 69 6e 20 74 68 65 20 75 73 61 62 fit in the usab
3ba0: 6c 65 20 73 70 61 63 65 0a 6f 66 20 61 20 70 61 le space.of a pa
3bb0: 67 65 2e 20 20 54 68 65 20 6d 69 6e 69 6d 75 6d ge. The minimum
3bc0: 20 75 73 61 62 6c 65 20 73 70 61 63 65 20 69 73 usable space is
3bd0: 20 34 38 30 20 62 79 74 65 73 20 73 6f 20 74 68 480 bytes so th
3be0: 65 20 61 72 72 61 79 20 77 69 6c 6c 20 61 6c 77 e array will alw
3bf0: 61 79 73 0a 62 65 20 61 74 20 6c 65 61 73 74 20 ays.be at least
3c00: 31 32 30 20 65 6e 74 72 69 65 73 20 69 6e 20 6c 120 entries in l
3c10: 65 6e 67 74 68 2e 20 20 54 68 65 20 66 69 72 73 ength. The firs
3c20: 74 20 69 6e 74 65 67 65 72 20 69 6e 20 74 68 65 t integer in the
3c30: 20 61 72 72 61 79 20 0a 69 73 20 74 68 65 20 70 array .is the p
3c40: 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 age number of th
3c50: 65 20 6e 65 78 74 20 66 72 65 65 6c 69 73 74 20 e next freelist
3c60: 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 trunk page in th
3c70: 65 20 6c 69 73 74 20 6f 72 20 7a 65 72 6f 20 0a e list or zero .
3c80: 69 66 20 74 68 69 73 20 69 73 20 74 68 65 20 6c if this is the l
3c90: 61 73 74 20 66 72 65 65 6c 69 73 74 20 74 72 75 ast freelist tru
3ca0: 6e 6b 20 70 61 67 65 2e 20 20 54 68 65 20 73 65 nk page. The se
3cb0: 63 6f 6e 64 20 69 6e 74 65 67 65 72 20 69 6e 20 cond integer in
3cc0: 74 68 65 20 61 72 72 61 79 0a 69 73 20 74 68 65 the array.is the
3cd0: 20 6e 75 6d 62 65 72 20 6f 66 20 6c 65 61 66 20 number of leaf
3ce0: 70 61 67 65 20 70 6f 69 6e 74 65 72 73 20 74 6f page pointers to
3cf0: 20 66 6f 6c 6c 6f 77 2e 20 20 43 61 6c 6c 20 74 follow. Call t
3d00: 68 65 20 73 65 63 6f 6e 64 20 69 6e 74 65 67 65 he second intege
3d10: 72 20 4c 2e 0a 49 66 20 4c 20 69 73 20 67 72 65 r L..If L is gre
3d20: 61 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 20 74 ater than zero t
3d30: 68 65 6e 20 69 6e 74 65 67 65 72 73 20 77 69 74 hen integers wit
3d40: 68 20 61 72 72 61 79 20 69 6e 64 65 78 65 73 20 h array indexes
3d50: 62 65 74 77 65 65 6e 20 32 20 61 6e 64 0a 4c 2b between 2 and.L+
3d60: 31 20 69 6e 63 6c 75 73 69 76 65 20 63 6f 6e 74 1 inclusive cont
3d70: 61 69 6e 20 70 61 67 65 20 6e 75 6d 62 65 72 73 ain page numbers
3d80: 20 66 6f 72 20 66 72 65 65 6c 69 73 74 20 6c 65 for freelist le
3d90: 61 66 20 70 61 67 65 73 2e 3c 2f 70 3e 0a 0a 3c af pages.</p>..<
3da0: 70 3e 46 72 65 65 6c 69 73 74 20 6c 65 61 66 20 p>Freelist leaf
3db0: 70 61 67 65 73 20 63 6f 6e 74 61 69 6e 20 6e 6f pages contain no
3dc0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 53 information. S
3dd0: 51 4c 69 74 65 20 61 76 6f 69 64 20 72 65 61 64 QLite avoid read
3de0: 69 6e 67 20 6f 72 0a 77 72 69 74 69 6e 67 20 66 ing or.writing f
3df0: 72 65 65 6c 69 73 74 20 6c 65 61 66 20 70 61 67 reelist leaf pag
3e00: 65 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 72 es in order to r
3e10: 65 64 75 63 65 20 64 69 73 6b 20 49 2f 4f 2e 3c educe disk I/O.<
3e20: 2f 70 3e 0a 0a 3c 70 3e 41 20 62 75 67 20 69 6e /p>..<p>A bug in
3e30: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 73 SQLite versions
3e40: 20 70 72 69 6f 72 20 74 6f 20 33 2e 36 2e 30 20 prior to 3.6.0
3e50: 63 61 75 73 65 64 20 74 68 65 20 64 61 74 61 62 caused the datab
3e60: 61 73 65 20 74 6f 20 62 65 0a 72 65 70 6f 72 74 ase to be.report
3e70: 65 64 20 61 73 20 63 6f 72 72 75 70 74 20 69 66 ed as corrupt if
3e80: 20 61 6e 79 20 6c 61 73 74 20 36 20 65 6e 74 72 any last 6 entr
3e90: 69 65 73 20 69 6e 20 74 68 65 20 66 72 65 65 6c ies in the freel
3ea0: 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 0a ist trunk page .
3eb0: 61 72 72 61 79 20 63 6f 6e 74 61 69 6e 65 64 20 array contained
3ec0: 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 73 2e non-zero values.
3ed0: 20 20 4e 65 77 65 72 20 76 65 72 73 69 6f 6e 73 Newer versions
3ee0: 20 6f 66 20 53 51 4c 69 74 65 20 64 6f 20 6e 6f of SQLite do no
3ef0: 74 20 68 61 76 65 0a 74 68 69 73 20 70 72 6f 62 t have.this prob
3f00: 6c 65 6d 2e 20 20 48 6f 77 65 76 65 72 2c 20 6e lem. However, n
3f10: 65 77 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 ewer versions of
3f20: 20 53 51 4c 69 74 65 20 73 74 69 6c 6c 20 61 76 SQLite still av
3f30: 6f 69 64 20 75 73 69 6e 67 20 74 68 65 20 0a 6c oid using the .l
3f40: 61 73 74 20 73 69 78 20 65 6e 74 72 69 65 73 20 ast six entries
3f50: 69 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 in the freelist
3f60: 74 72 75 6e 6b 20 70 61 67 65 20 61 72 72 61 79 trunk page array
3f70: 20 69 6e 20 6f 72 64 65 72 20 74 68 61 74 20 64 in order that d
3f80: 61 74 61 62 61 73 65 0a 66 69 6c 65 73 20 63 72 atabase.files cr
3f90: 65 61 74 65 64 20 62 79 20 6e 65 77 65 72 20 76 eated by newer v
3fa0: 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 ersions of SQLit
3fb0: 65 20 63 61 6e 20 62 65 20 72 65 61 64 20 62 79 e can be read by
3fc0: 20 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 0a older versions.
3fd0: 6f 66 20 53 51 4c 69 74 65 2e 3c 2f 70 3e 0a 0a of SQLite.</p>..
3fe0: 3c 70 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 <p>The number of
3ff0: 20 66 72 65 65 6c 69 73 74 20 70 61 67 65 73 20 freelist pages
4000: 69 73 20 73 74 6f 72 65 64 20 61 73 20 61 20 34 is stored as a 4
4010: 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e -byte big-endian
4020: 20 69 6e 74 65 67 65 72 0a 69 6e 20 74 68 65 20 integer.in the
4030: 64 61 74 61 62 61 73 65 20 68 65 61 64 65 72 20 database header
4040: 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f 66 20 at an offset of
4050: 33 36 20 66 72 6f 6d 20 74 68 65 20 62 65 67 69 36 from the begi
4060: 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 66 69 6c nning of the fil
4070: 65 2e 0a 54 68 65 20 64 61 74 61 62 61 73 65 20 e..The database
4080: 68 65 61 64 65 72 20 61 6c 73 6f 20 73 74 6f 72 header also stor
4090: 65 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 es the page numb
40a0: 65 72 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 er of the first
40b0: 66 72 65 65 6c 69 73 74 20 74 72 75 6e 6b 0a 70 freelist trunk.p
40c0: 61 67 65 20 61 73 20 61 20 34 2d 62 79 74 65 20 age as a 4-byte
40d0: 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 big-endian integ
40e0: 65 72 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 er at an offset
40f0: 6f 66 20 33 32 20 66 72 6f 6d 20 74 68 65 20 62 of 32 from the b
4100: 65 67 69 6e 6e 69 6e 67 0a 6f 66 20 74 68 65 20 eginning.of the
4110: 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 31 file.</p>..<h3>1
4120: 2e 35 20 42 2d 74 72 65 65 20 50 61 67 65 73 3c .5 B-tree Pages<
4130: 2f 68 33 3e 0a 0a 3c 70 3e 41 20 62 2d 74 72 65 /h3>..<p>A b-tre
4140: 65 20 70 61 67 65 20 69 73 20 65 69 74 68 65 72 e page is either
4150: 20 61 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 67 an interior pag
4160: 65 20 6f 72 20 61 20 6c 65 61 66 20 70 61 67 65 e or a leaf page
4170: 2e 0a 41 20 6c 65 61 66 20 70 61 67 65 20 63 6f ..A leaf page co
4180: 6e 74 61 69 6e 73 20 6b 65 79 73 20 61 6e 64 20 ntains keys and
4190: 69 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20 61 in the case of a
41a0: 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 65 61 table b-tree ea
41b0: 63 68 0a 6b 65 79 20 68 61 73 20 61 73 73 6f 63 ch.key has assoc
41c0: 69 61 74 65 64 20 63 6f 6e 74 65 6e 74 2e 20 20 iated content.
41d0: 41 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 67 65 An interior page
41e0: 20 63 6f 6e 74 61 69 6e 73 0a 4b 20 6b 65 79 73 contains.K keys
41f0: 20 77 69 74 68 6f 75 74 20 63 6f 6e 74 65 6e 74 without content
4200: 20 62 75 74 20 77 69 74 68 20 4b 2b 31 20 70 6f but with K+1 po
4210: 69 6e 74 65 72 73 20 74 6f 20 63 68 69 6c 64 20 inters to child
4220: 62 2d 74 72 65 65 20 70 61 67 65 73 2e 0a 41 20 b-tree pages..A
4230: 22 70 6f 69 6e 74 65 72 22 20 69 6e 20 61 6e 20 "pointer" in an
4240: 69 6e 74 65 72 69 6f 72 20 62 2d 74 72 65 65 20 interior b-tree
4250: 70 61 67 65 20 69 73 20 6a 75 73 74 20 74 68 65 page is just the
4260: 20 33 31 2d 62 69 74 20 69 6e 74 65 67 65 72 0a 31-bit integer.
4270: 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 page number of t
4280: 68 65 20 63 68 69 6c 64 20 70 61 67 65 2e 3c 2f he child page.</
4290: 70 3e 0a 0a 0a 3c 70 3e 44 65 66 69 6e 65 20 74 p>...<p>Define t
42a0: 68 65 20 64 65 70 74 68 0a 6f 66 20 61 20 6c 65 he depth.of a le
42b0: 61 66 20 62 2d 74 72 65 65 20 74 6f 20 62 65 20 af b-tree to be
42c0: 31 20 61 6e 64 20 74 68 61 74 20 74 68 65 20 64 1 and that the d
42d0: 65 70 74 68 20 6f 66 20 61 6e 79 20 69 6e 74 65 epth of any inte
42e0: 72 69 6f 72 20 62 2d 74 72 65 65 20 74 6f 20 62 rior b-tree to b
42f0: 65 20 6f 6e 65 0a 6d 6f 72 65 20 74 68 61 6e 20 e one.more than
4300: 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 65 70 74 the maximum dept
4310: 68 20 6f 66 20 61 6e 79 20 6f 66 20 69 74 73 20 h of any of its
4320: 63 68 69 6c 64 72 65 6e 2e 20 20 49 6e 20 61 20 children. In a
4330: 77 65 6c 6c 2d 66 6f 72 6d 65 64 0a 64 61 74 61 well-formed.data
4340: 62 61 73 65 2c 20 61 6c 6c 20 63 68 69 6c 64 72 base, all childr
4350: 65 6e 20 6f 66 20 61 6e 79 20 6f 6e 65 20 69 6e en of any one in
4360: 74 65 72 69 6f 72 20 62 2d 74 72 65 65 20 68 61 terior b-tree ha
4370: 76 65 20 74 68 65 20 73 61 6d 65 20 64 65 70 74 ve the same dept
4380: 68 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 61 6e h.</p>..<p>In an
4390: 20 69 6e 74 65 72 69 6f 72 20 62 2d 74 72 65 65 interior b-tree
43a0: 20 70 61 67 65 2c 20 74 68 65 20 70 6f 69 6e 74 page, the point
43b0: 65 72 73 20 61 6e 64 20 6b 65 79 73 20 6c 6f 67 ers and keys log
43c0: 69 63 61 6c 6c 79 20 61 6c 74 65 72 6e 61 74 65 ically alternate
43d0: 20 0a 77 69 74 68 20 61 20 70 6f 69 6e 74 65 72 .with a pointer
43e0: 20 6f 6e 20 62 6f 74 68 20 65 6e 64 73 2e 20 28 on both ends. (
43f0: 54 68 65 20 70 72 65 76 69 6f 75 73 20 73 65 6e The previous sen
4400: 74 65 6e 63 65 20 69 73 20 74 6f 20 62 65 20 75 tence is to be u
4410: 6e 64 65 72 73 74 6f 6f 64 0a 63 6f 6e 63 65 70 nderstood.concep
4420: 74 75 61 6c 6c 79 20 2d 20 74 68 65 20 61 63 74 tually - the act
4430: 75 61 6c 20 6c 61 79 6f 75 74 20 6f 66 20 74 68 ual layout of th
4440: 65 20 6b 65 79 73 20 61 6e 64 0a 70 6f 69 6e 74 e keys and.point
4450: 65 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 ers within the p
4460: 61 67 65 20 69 73 20 6d 6f 72 65 20 63 6f 6d 70 age is more comp
4470: 6c 69 63 61 74 65 64 20 61 6e 64 20 77 69 6c 6c licated and will
4480: 20 62 65 20 64 65 73 63 72 69 62 65 64 20 69 6e be described in
4490: 0a 74 68 65 20 73 65 71 75 65 6c 2e 29 20 20 41 .the sequel.) A
44a0: 6c 6c 20 6b 65 79 73 20 77 69 74 68 69 6e 20 74 ll keys within t
44b0: 68 65 20 73 61 6d 65 20 70 61 67 65 20 61 72 65 he same page are
44c0: 20 75 6e 69 71 75 65 20 61 6e 64 20 61 72 65 20 unique and are
44d0: 6f 72 67 61 6e 69 7a 65 64 0a 69 6e 20 61 73 63 organized.in asc
44e0: 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 66 72 6f ending order fro
44f0: 6d 20 6c 65 66 74 20 74 6f 20 72 69 67 68 74 2e m left to right.
4500: 20 20 46 6f 72 20 61 6e 79 20 6b 65 79 20 58 2c For any key X,
4510: 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 65 pointers to the
4520: 20 6c 65 66 74 0a 6f 66 20 61 20 58 20 72 65 66 left.of a X ref
4530: 65 72 20 74 6f 20 62 2d 74 72 65 65 20 70 61 67 er to b-tree pag
4540: 65 73 20 6f 6e 20 77 68 69 63 68 20 61 6c 6c 73 es on which alls
4550: 20 6b 65 79 73 20 61 72 65 20 6c 65 73 73 20 74 keys are less t
4560: 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 han or equal to
4570: 58 2e 0a 50 6f 69 6e 74 65 72 73 20 74 6f 20 74 X..Pointers to t
4580: 68 65 20 72 69 67 68 74 20 6f 66 20 58 20 72 65 he right of X re
4590: 66 65 72 20 74 6f 20 70 61 67 65 73 20 77 68 65 fer to pages whe
45a0: 72 65 20 61 6c 6c 20 6b 65 79 73 20 61 72 65 20 re all keys are
45b0: 67 72 65 61 74 65 72 20 74 68 61 6e 20 58 2e 3c greater than X.<
45c0: 2f 70 3e 0a 0a 3c 70 3e 57 69 74 68 69 6e 20 61 /p>..<p>Within a
45d0: 6e 20 69 6e 74 65 72 69 6f 72 20 62 2d 74 72 65 n interior b-tre
45e0: 65 20 70 61 67 65 2c 20 65 61 63 68 20 6b 65 79 e page, each key
45f0: 20 61 6e 64 20 74 68 65 20 70 6f 69 6e 74 65 72 and the pointer
4600: 20 74 6f 20 69 74 73 0a 69 6d 6d 65 64 69 61 74 to its.immediat
4610: 65 20 6c 65 66 74 20 61 72 65 20 63 6f 6d 62 69 e left are combi
4620: 6e 65 64 20 69 6e 74 6f 20 61 20 73 74 72 75 63 ned into a struc
4630: 74 75 72 65 20 63 61 6c 6c 65 64 20 61 20 22 63 ture called a "c
4640: 65 6c 6c 22 2e 20 20 54 68 65 0a 72 69 67 68 74 ell". The.right
4650: 2d 6d 6f 73 74 20 70 6f 69 6e 74 65 72 20 69 73 -most pointer is
4660: 20 68 65 6c 64 20 73 65 70 61 72 61 74 65 6c 79 held separately
4670: 2e 20 20 41 20 6c 65 61 66 20 62 2d 74 72 65 65 . A leaf b-tree
4680: 20 70 61 67 65 20 68 61 73 20 6e 6f 0a 70 6f 69 page has no.poi
4690: 6e 74 65 72 73 2c 20 62 75 74 20 69 74 20 73 74 nters, but it st
46a0: 69 6c 6c 20 75 73 65 73 20 74 68 65 20 63 65 6c ill uses the cel
46b0: 6c 20 73 74 72 75 63 74 75 72 65 20 74 6f 20 68 l structure to h
46c0: 6f 6c 64 20 6b 65 79 73 20 66 6f 72 0a 69 6e 64 old keys for.ind
46d0: 65 78 20 62 2d 74 72 65 65 73 20 6f 72 20 6b 65 ex b-trees or ke
46e0: 79 73 20 61 6e 64 20 63 6f 6e 74 65 6e 74 20 66 ys and content f
46f0: 6f 72 20 74 61 62 6c 65 20 62 2d 74 72 65 65 73 or table b-trees
4700: 2e 3c 2f 70 3e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 45 .</p>.</p>..<p>E
4710: 76 65 72 79 20 62 2d 74 72 65 65 20 70 61 67 65 very b-tree page
4720: 20 68 61 73 20 61 74 20 6d 6f 73 74 20 6f 6e 65 has at most one
4730: 20 70 61 72 65 6e 74 20 62 2d 74 72 65 65 20 70 parent b-tree p
4740: 61 67 65 2e 0a 41 20 62 2d 74 72 65 65 20 70 61 age..A b-tree pa
4750: 67 65 20 77 69 74 68 6f 75 74 20 61 20 70 61 72 ge without a par
4760: 65 6e 74 20 69 73 20 63 61 6c 6c 65 64 20 61 20 ent is called a
4770: 72 6f 6f 74 20 70 61 67 65 2e 20 20 41 20 72 6f root page. A ro
4780: 6f 74 20 62 2d 74 72 65 65 20 70 61 67 65 0a 74 ot b-tree page.t
4790: 6f 67 65 74 68 65 72 20 77 69 74 68 20 74 68 65 ogether with the
47a0: 20 63 6c 6f 73 75 72 65 20 6f 66 20 69 74 73 20 closure of its
47b0: 63 68 69 6c 64 72 65 6e 20 66 6f 72 6d 20 61 20 children form a
47c0: 63 6f 6d 70 6c 65 74 65 20 62 2d 74 72 65 65 2e complete b-tree.
47d0: 0a 49 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 .It is possible
47e0: 28 61 6e 64 20 69 6e 20 66 61 63 74 20 72 61 74 (and in fact rat
47f0: 68 65 72 20 63 6f 6d 6d 6f 6e 29 20 74 6f 20 68 her common) to h
4800: 61 76 65 20 61 20 63 6f 6d 70 6c 65 74 65 20 62 ave a complete b
4810: 2d 74 72 65 65 0a 74 68 61 74 20 63 6f 6e 73 69 -tree.that consi
4820: 73 74 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 sts of a single
4830: 70 61 67 65 20 74 68 61 74 20 69 73 20 62 6f 74 page that is bot
4840: 68 20 61 20 6c 65 61 66 20 61 6e 64 20 74 68 65 h a leaf and the
4850: 20 72 6f 6f 74 2e 0a 42 65 63 61 75 73 65 20 74 root..Because t
4860: 68 65 72 65 20 61 72 65 20 70 6f 69 6e 74 65 72 here are pointer
4870: 73 20 66 72 6f 6d 20 70 61 72 65 6e 74 73 20 74 s from parents t
4880: 6f 20 63 68 69 6c 64 72 65 6e 2c 20 65 76 65 72 o children, ever
4890: 79 20 70 61 67 65 20 6f 66 20 61 0a 63 6f 6d 70 y page of a.comp
48a0: 6c 65 74 65 20 62 2d 74 72 65 65 20 63 61 6e 20 lete b-tree can
48b0: 62 65 20 6c 6f 63 61 74 65 64 20 69 66 20 6f 6e be located if on
48c0: 6c 79 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 ly the root page
48d0: 20 69 73 20 6b 6e 6f 77 6e 2e 20 20 48 65 6e 63 is known. Henc
48e0: 65 2c 0a 62 2d 74 72 65 65 73 20 61 72 65 20 69 e,.b-trees are i
48f0: 64 65 6e 74 69 66 69 65 64 20 62 79 20 74 68 65 dentified by the
4900: 69 72 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d ir root page num
4910: 62 65 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 62 ber.</p>..<p>A b
4920: 2d 74 72 65 65 20 70 61 67 65 20 69 73 20 65 69 -tree page is ei
4930: 74 68 65 72 20 61 20 74 61 62 6c 65 20 62 2d 74 ther a table b-t
4940: 72 65 65 20 70 61 67 65 20 6f 72 20 61 6e 20 69 ree page or an i
4950: 6e 64 65 78 20 62 2d 74 72 65 65 20 70 61 67 65 ndex b-tree page
4960: 2e 0a 41 6c 6c 20 70 61 67 65 73 20 77 69 74 68 ..All pages with
4970: 69 6e 20 65 61 63 68 20 63 6f 6d 70 6c 65 74 65 in each complete
4980: 20 62 2d 74 72 65 65 20 61 72 65 20 6f 66 20 74 b-tree are of t
4990: 68 65 20 73 61 6d 65 20 74 79 70 65 3a 20 65 69 he same type: ei
49a0: 74 68 65 72 20 74 61 62 6c 65 0a 6f 72 20 69 6e ther table.or in
49b0: 64 65 78 2e 20 20 54 68 65 72 65 20 69 73 20 61 dex. There is a
49c0: 20 6f 6e 65 2d 74 6f 2d 6f 6e 65 20 6d 61 70 70 one-to-one mapp
49d0: 69 6e 67 20 66 72 6f 6d 20 74 61 62 6c 65 20 62 ing from table b
49e0: 2d 74 72 65 65 73 20 69 6e 20 74 68 65 20 64 61 -trees in the da
49f0: 74 61 62 61 73 65 20 0a 66 69 6c 65 20 74 6f 20 tabase .file to
4a00: 28 6e 6f 6e 2d 76 69 72 74 75 61 6c 29 20 74 61 (non-virtual) ta
4a10: 62 6c 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 bles in the data
4a20: 62 61 73 65 20 73 63 68 65 6d 61 2c 20 69 6e 63 base schema, inc
4a30: 6c 75 64 69 6e 67 20 73 79 73 74 65 6d 20 74 61 luding system ta
4a40: 62 6c 65 73 0a 73 75 63 68 20 61 73 20 73 71 6c bles.such as sql
4a50: 69 74 65 5f 6d 61 73 74 65 72 2e 20 20 54 68 65 ite_master. The
4a60: 72 65 20 69 73 20 6f 6e 65 2d 74 6f 2d 6f 6e 65 re is one-to-one
4a70: 20 6d 61 70 70 69 6e 67 20 62 65 74 77 65 65 6e mapping between
4a80: 20 69 6e 64 65 78 20 62 2d 74 72 65 65 73 0a 69 index b-trees.i
4a90: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
4aa0: 69 6c 65 20 61 6e 64 20 69 6e 64 69 63 65 73 20 ile and indices
4ab0: 69 6e 20 74 68 65 20 73 63 68 65 6d 61 2c 20 69 in the schema, i
4ac0: 6e 63 6c 75 64 69 6e 67 20 69 6d 70 6c 69 65 64 ncluding implied
4ad0: 20 69 6e 64 69 63 65 73 0a 63 72 65 61 74 65 64 indices.created
4ae0: 20 62 79 20 75 6e 69 71 75 65 6e 65 73 73 20 63 by uniqueness c
4af0: 6f 6e 73 74 72 61 69 6e 74 73 2e 20 20 54 68 65 onstraints. The
4b00: 20 62 2d 74 72 65 65 20 63 6f 72 72 65 73 70 6f b-tree correspo
4b10: 6e 64 69 6e 67 20 74 6f 20 74 68 65 0a 73 71 6c nding to the.sql
4b20: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 ite_master table
4b30: 20 61 6c 77 61 79 73 20 68 61 73 20 69 74 73 20 always has its
4b40: 72 6f 6f 74 20 70 61 67 65 20 6f 6e 20 61 20 70 root page on a p
4b50: 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 31 2e age number of 1.
4b60: 0a 54 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 .The sqlite_mast
4b70: 65 72 20 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e er table contain
4b80: 73 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 s the root page
4b90: 6e 75 6d 62 65 72 20 66 6f 72 20 65 76 65 72 79 number for every
4ba0: 20 6f 74 68 65 72 20 0a 74 61 62 6c 65 20 61 6e other .table an
4bb0: 64 20 69 6e 64 65 78 20 69 6e 20 74 68 65 20 64 d index in the d
4bc0: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 3c 2f 70 atabase file.</p
4bd0: 3e 0a 0a 3c 70 3e 45 61 63 68 20 65 6e 74 72 79 >..<p>Each entry
4be0: 20 69 6e 20 61 20 74 61 62 6c 65 20 62 2d 74 72 in a table b-tr
4bf0: 65 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 ee consists of a
4c00: 20 36 34 2d 62 69 74 20 73 69 67 6e 65 64 20 69 64-bit signed i
4c10: 6e 74 65 67 65 72 20 6b 65 79 0a 61 6e 64 20 75 nteger key.and u
4c20: 70 20 74 6f 20 32 31 34 37 34 38 33 36 34 37 20 p to 2147483647
4c30: 62 79 74 65 73 20 6f 66 20 61 72 62 69 74 72 61 bytes of arbitra
4c40: 72 79 20 64 61 74 61 2e 20 20 49 6e 74 65 72 69 ry data. Interi
4c50: 6f 72 20 74 61 62 6c 65 20 62 2d 74 72 65 65 73 or table b-trees
4c60: 0a 68 6f 6c 64 20 6f 6e 6c 79 20 6b 65 79 73 20 .hold only keys
4c70: 61 6e 64 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 and pointers to
4c80: 63 68 69 6c 64 72 65 6e 2e 20 20 41 6c 6c 20 64 children. All d
4c90: 61 74 61 20 69 73 20 63 6f 6e 74 61 69 6e 65 64 ata is contained
4ca0: 20 69 6e 20 74 68 65 0a 74 61 62 6c 65 20 62 2d in the.table b-
4cb0: 74 72 65 65 20 6c 65 61 76 65 73 2e 3c 2f 70 3e tree leaves.</p>
4cc0: 0a 0a 3c 70 3e 45 61 63 68 20 65 6e 74 72 79 20 ..<p>Each entry
4cd0: 69 6e 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 in an index b-tr
4ce0: 65 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 ee consists of a
4cf0: 6e 20 61 72 62 69 74 72 61 72 79 20 6b 65 79 20 n arbitrary key
4d00: 6f 66 20 75 70 0a 74 6f 20 32 31 34 37 34 38 33 of up.to 2147483
4d10: 36 34 37 20 62 79 74 65 73 20 69 6e 20 6c 65 6e 647 bytes in len
4d20: 67 74 68 20 61 6e 64 20 6e 6f 20 64 61 74 61 2e gth and no data.
4d30: 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 68 64 5f 66 72 </p>..<tcl>hd_fr
4d40: 61 67 6d 65 6e 74 20 63 65 6c 6c 5f 70 61 79 6c agment cell_payl
4d50: 6f 61 64 20 7b 63 65 6c 6c 20 70 61 79 6c 6f 61 oad {cell payloa
4d60: 64 7d 3c 2f 74 63 6c 3e 0a 3c 70 3e 44 65 66 69 d}</tcl>.<p>Defi
4d70: 6e 65 20 74 68 65 20 22 70 61 79 6c 6f 61 64 22 ne the "payload"
4d80: 20 6f 66 20 61 20 63 65 6c 6c 20 74 6f 20 62 65 of a cell to be
4d90: 20 74 68 65 20 61 72 62 69 74 72 61 72 79 20 6c the arbitrary l
4da0: 65 6e 67 74 68 20 73 65 63 74 69 6f 6e 0a 6f 66 ength section.of
4db0: 20 74 68 65 20 63 65 6c 6c 2e 20 20 46 6f 72 20 the cell. For
4dc0: 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 2c an index b-tree,
4dd0: 20 74 68 65 20 6b 65 79 20 69 73 20 61 6c 77 61 the key is alwa
4de0: 79 73 20 61 72 62 69 74 72 61 72 79 20 69 6e 20 ys arbitrary in
4df0: 6c 65 6e 67 74 68 0a 61 6e 64 20 68 65 6e 63 65 length.and hence
4e00: 20 74 68 65 20 70 61 79 6c 6f 61 64 20 69 73 20 the payload is
4e10: 74 68 65 20 6b 65 79 2e 20 20 54 68 65 72 65 20 the key. There
4e20: 61 72 65 20 6e 6f 20 61 72 62 69 74 72 61 72 79 are no arbitrary
4e30: 20 6c 65 6e 67 74 68 20 65 6c 65 6d 65 6e 74 73 length elements
4e40: 0a 69 6e 20 74 68 65 20 63 65 6c 6c 73 20 6f 66 .in the cells of
4e50: 20 69 6e 74 65 72 69 6f 72 20 74 61 62 6c 65 20 interior table
4e60: 62 2d 74 72 65 65 20 70 61 67 65 73 20 61 6e 64 b-tree pages and
4e70: 20 73 6f 20 74 68 6f 73 65 20 63 65 6c 6c 73 20 so those cells
4e80: 68 61 76 65 20 6e 6f 0a 70 61 79 6c 6f 61 64 2e have no.payload.
4e90: 20 20 54 61 62 6c 65 20 62 2d 74 72 65 65 20 6c Table b-tree l
4ea0: 65 61 66 20 70 61 67 65 73 20 63 6f 6e 74 61 69 eaf pages contai
4eb0: 6e 20 61 72 62 69 74 72 61 72 79 20 6c 65 6e 67 n arbitrary leng
4ec0: 74 68 20 63 6f 6e 74 65 6e 74 20 61 6e 64 0a 73 th content and.s
4ed0: 6f 20 66 6f 72 20 63 65 6c 6c 73 20 6f 6e 20 74 o for cells on t
4ee0: 68 6f 73 65 20 70 61 67 65 73 20 74 68 65 20 70 hose pages the p
4ef0: 61 79 6c 6f 61 64 20 69 73 20 74 68 65 20 63 6f ayload is the co
4f00: 6e 74 65 6e 74 2e 0a 3c 70 3e 57 68 65 6e 20 74 ntent..<p>When t
4f10: 68 65 20 73 69 7a 65 20 6f 66 20 70 61 79 6c 6f he size of paylo
4f20: 61 64 20 66 6f 72 20 61 20 63 65 6c 6c 20 65 78 ad for a cell ex
4f30: 63 65 65 64 73 20 61 20 63 65 72 74 61 69 6e 20 ceeds a certain
4f40: 74 68 72 65 73 68 6f 6c 64 20 28 74 6f 0a 62 65 threshold (to.be
4f50: 20 64 65 66 69 6e 65 64 20 6c 61 74 65 72 29 20 defined later)
4f60: 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 20 66 69 then only the fi
4f70: 72 73 74 20 66 65 77 20 62 79 74 65 73 20 6f 66 rst few bytes of
4f80: 20 74 68 65 20 70 61 79 6c 6f 61 64 0a 61 72 65 the payload.are
4f90: 20 73 74 6f 72 65 64 20 6f 6e 20 74 68 65 20 62 stored on the b
4fa0: 2d 74 72 65 65 20 70 61 67 65 20 61 6e 64 20 74 -tree page and t
4fb0: 68 65 20 62 61 6c 61 6e 63 65 20 69 73 20 73 74 he balance is st
4fc0: 6f 72 65 64 20 69 6e 20 61 20 6c 69 6e 6b 65 64 ored in a linked
4fd0: 20 6c 69 73 74 0a 6f 66 20 63 6f 6e 74 65 6e 74 list.of content
4fe0: 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e overflow pages.
4ff0: 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 62 2d 74 72 65 </p>..<p>A b-tre
5000: 65 20 70 61 67 65 20 69 73 20 64 69 76 69 64 65 e page is divide
5010: 64 20 69 6e 74 6f 20 72 65 67 69 6f 6e 73 20 69 d into regions i
5020: 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 n the following
5030: 6f 72 64 65 72 3a 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 order:..<ol>.<li
5040: 3e 54 68 65 20 31 30 30 2d 62 79 74 65 20 64 61 >The 100-byte da
5050: 74 61 62 61 73 65 20 66 69 6c 65 20 68 65 61 64 tabase file head
5060: 65 72 20 28 66 6f 75 6e 64 20 6f 6e 20 70 61 67 er (found on pag
5070: 65 20 31 20 6f 6e 6c 79 29 0a 3c 6c 69 3e 54 68 e 1 only).<li>Th
5080: 65 20 38 20 6f 72 20 31 32 20 62 79 74 65 20 62 e 8 or 12 byte b
5090: 2d 74 72 65 65 20 70 61 67 65 20 68 65 61 64 65 -tree page heade
50a0: 72 0a 3c 6c 69 3e 54 68 65 20 63 65 6c 6c 20 70 r.<li>The cell p
50b0: 6f 69 6e 74 65 72 20 61 72 72 61 79 0a 3c 6c 69 ointer array.<li
50c0: 3e 55 6e 61 6c 6c 6f 63 61 74 65 64 20 73 70 61 >Unallocated spa
50d0: 63 65 0a 3c 6c 69 3e 54 68 65 20 63 65 6c 6c 20 ce.<li>The cell
50e0: 63 6f 6e 74 65 6e 74 20 61 72 65 61 0a 3c 6c 69 content area.<li
50f0: 3e 54 68 65 20 72 65 73 65 72 76 65 64 20 72 65 >The reserved re
5100: 67 69 6f 6e 2e 0a 3c 2f 6f 6c 3e 0a 3c 2f 70 3e gion..</ol>.</p>
5110: 0a 0a 3c 70 3e 54 68 65 20 31 30 30 2d 62 79 74 ..<p>The 100-byt
5120: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
5130: 68 65 61 64 65 72 20 69 73 20 66 6f 75 6e 64 20 header is found
5140: 6f 6e 6c 79 20 6f 6e 20 70 61 67 65 20 31 2c 20 only on page 1,
5150: 77 68 69 63 68 20 69 73 0a 61 6c 77 61 79 73 20 which is.always
5160: 61 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 70 a table b-tree p
5170: 61 67 65 2e 20 20 41 6c 6c 20 6f 74 68 65 72 20 age. All other
5180: 62 2d 74 72 65 65 20 70 61 67 65 73 20 69 6e 20 b-tree pages in
5190: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
51a0: 65 0a 6f 6d 69 74 20 74 68 69 73 20 31 30 30 2d e.omit this 100-
51b0: 62 79 74 65 20 68 65 61 64 65 72 2e 3c 2f 70 3e byte header.</p>
51c0: 0a 0a 3c 70 3e 54 68 65 20 72 65 73 65 72 76 65 ..<p>The reserve
51d0: 64 20 72 65 67 69 6f 6e 20 69 73 20 61 6e 20 61 d region is an a
51e0: 72 65 61 20 6f 66 20 75 6e 75 73 65 64 20 73 70 rea of unused sp
51f0: 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f ace at the end o
5200: 66 20 65 76 65 72 79 0a 70 61 67 65 20 28 65 78 f every.page (ex
5210: 63 65 70 74 20 74 68 65 20 6c 6f 63 6b 69 6e 67 cept the locking
5220: 20 70 61 67 65 29 20 74 68 61 74 20 65 78 74 65 page) that exte
5230: 6e 73 69 6f 6e 73 20 63 61 6e 20 75 73 65 20 74 nsions can use t
5240: 6f 20 68 6f 6c 64 20 70 65 72 2d 70 61 67 65 0a o hold per-page.
5250: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 54 68 information. Th
5260: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 72 65 e size of the re
5270: 73 65 72 76 65 64 20 72 65 67 69 6f 6e 20 69 73 served region is
5280: 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 determined by t
5290: 68 65 20 6f 6e 65 2d 62 79 74 65 0a 75 6e 73 69 he one-byte.unsi
52a0: 67 6e 65 64 20 69 6e 74 65 67 65 72 20 66 6f 75 gned integer fou
52b0: 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 nd at an offset
52c0: 6f 66 20 32 30 20 69 6e 74 6f 20 74 68 65 20 64 of 20 into the d
52d0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 65 61 atabase file hea
52e0: 64 65 72 2e 0a 54 68 65 20 73 69 7a 65 20 6f 66 der..The size of
52f0: 20 74 68 65 20 72 65 73 65 72 76 65 64 20 72 65 the reserved re
5300: 67 69 6f 6e 20 69 73 20 75 73 75 61 6c 6c 79 20 gion is usually
5310: 7a 65 72 6f 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 zero.</p>..<p>Th
5320: 65 20 62 2d 74 72 65 65 20 70 61 67 65 20 68 65 e b-tree page he
5330: 61 64 65 72 20 69 73 20 38 20 62 79 74 65 73 20 ader is 8 bytes
5340: 69 6e 20 73 69 7a 65 20 66 6f 72 20 6c 65 61 66 in size for leaf
5350: 20 70 61 67 65 73 20 61 6e 64 20 31 32 0a 62 79 pages and 12.by
5360: 74 65 73 20 66 6f 72 20 69 6e 74 65 72 69 6f 72 tes for interior
5370: 20 70 61 67 65 73 2e 20 20 41 6c 6c 20 6d 75 6c pages. All mul
5380: 74 69 62 79 74 65 20 76 61 6c 75 65 73 20 69 6e tibyte values in
5390: 20 74 68 65 20 70 61 67 65 20 68 65 61 64 65 72 the page header
53a0: 0a 61 72 65 20 62 69 67 2d 65 6e 64 69 61 6e 2e .are big-endian.
53b0: 0a 54 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 .The b-tree page
53c0: 20 68 65 61 64 65 72 20 69 73 20 63 6f 6d 70 6f header is compo
53d0: 73 65 64 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f sed of the follo
53e0: 77 69 6e 67 20 66 69 65 6c 64 73 3a 3c 2f 70 3e wing fields:</p>
53f0: 0a 0a 3c 63 65 6e 74 65 72 3e 0a 3c 69 3e 42 2d ..<center>.<i>B-
5400: 74 72 65 65 20 50 61 67 65 20 48 65 61 64 65 72 tree Page Header
5410: 20 46 6f 72 6d 61 74 3c 2f 69 3e 3c 62 72 3e 0a Format</i><br>.
5420: 3c 74 61 62 6c 65 20 62 6f 72 64 65 72 3d 31 20 <table border=1
5430: 77 69 64 74 68 3d 22 38 30 25 22 3e 0a 3c 74 72 width="80%">.<tr
5440: 3e 3c 74 68 3e 4f 66 66 73 65 74 3c 74 68 3e 53 ><th>Offset<th>S
5450: 69 7a 65 3c 74 68 3e 44 65 73 63 72 69 70 74 69 ize<th>Descripti
5460: 6f 6e 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e on.<tr><td align
5470: 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 =center valign=t
5480: 6f 70 3e 30 3c 74 64 20 61 6c 69 67 6e 3d 63 65 op>0<td align=ce
5490: 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e nter valign=top>
54a0: 31 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 1<td align=left>
54b0: 0a 41 20 66 6c 61 67 20 69 6e 64 69 63 61 74 69 .A flag indicati
54c0: 6e 67 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 ng the b-tree pa
54d0: 67 65 20 74 79 70 65 0a 41 20 76 61 6c 75 65 20 ge type.A value
54e0: 6f 66 20 32 20 6d 65 61 6e 73 20 74 68 65 20 70 of 2 means the p
54f0: 61 67 65 20 69 73 20 61 6e 20 69 6e 74 65 72 69 age is an interi
5500: 6f 72 20 69 6e 64 65 78 20 62 2d 74 72 65 65 20 or index b-tree
5510: 70 61 67 65 2e 0a 41 20 76 61 6c 75 65 20 6f 66 page..A value of
5520: 20 35 20 6d 65 61 6e 73 20 74 68 65 20 70 61 67 5 means the pag
5530: 65 20 69 73 20 61 6e 20 69 6e 74 65 72 69 6f 72 e is an interior
5540: 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 70 61 table b-tree pa
5550: 67 65 2e 0a 41 20 76 61 6c 75 65 20 6f 66 20 31 ge..A value of 1
5560: 30 20 6d 65 61 6e 73 20 74 68 65 20 70 61 67 65 0 means the page
5570: 20 69 73 20 61 20 6c 65 61 66 20 69 6e 64 65 78 is a leaf index
5580: 20 62 2d 74 72 65 65 20 70 61 67 65 2e 0a 41 20 b-tree page..A
5590: 76 61 6c 75 65 20 6f 66 20 31 33 20 6d 65 61 6e value of 13 mean
55a0: 73 20 74 68 65 20 70 61 67 65 20 69 73 20 61 20 s the page is a
55b0: 6c 65 61 66 20 74 61 62 6c 65 20 62 2d 74 72 65 leaf table b-tre
55c0: 65 20 70 61 67 65 2e 0a 41 6e 79 20 6f 74 68 65 e page..Any othe
55d0: 72 20 76 61 6c 75 65 20 69 73 20 61 6e 20 65 72 r value is an er
55e0: 72 6f 72 2e 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 ror..<tr><td ali
55f0: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
5600: 3d 74 6f 70 3e 31 3c 74 64 20 61 6c 69 67 6e 3d =top>1<td align=
5610: 63 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f center valign=to
5620: 70 3e 32 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 p>2<td align=lef
5630: 74 3e 0a 42 79 74 65 20 6f 66 66 73 65 74 20 69 t>.Byte offset i
5640: 6e 74 6f 20 74 68 65 20 70 61 67 65 20 6f 66 20 nto the page of
5650: 74 68 65 20 66 69 72 73 74 20 66 72 65 65 62 6c the first freebl
5660: 6f 63 6b 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 ock.<tr><td alig
5670: 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d n=center valign=
5680: 74 6f 70 3e 33 3c 74 64 20 61 6c 69 67 6e 3d 63 top>3<td align=c
5690: 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 enter valign=top
56a0: 3e 32 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 >2<td align=left
56b0: 3e 0a 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c >.Number of cell
56c0: 73 20 6f 6e 20 74 68 69 73 20 70 61 67 65 0a 3c s on this page.<
56d0: 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e tr><td align=cen
56e0: 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 35 ter valign=top>5
56f0: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
5700: 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 32 3c 74 64 valign=top>2<td
5710: 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 4f 66 66 align=left>.Off
5720: 73 65 74 20 74 6f 20 74 68 65 20 66 69 72 73 74 set to the first
5730: 20 62 79 74 65 20 6f 66 20 74 68 65 20 63 65 6c byte of the cel
5740: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 0a 3c l content area.<
5750: 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e tr><td align=cen
5760: 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 37 ter valign=top>7
5770: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
5780: 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 31 3c 74 64 valign=top>1<td
5790: 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 4e 75 6d align=left>.Num
57a0: 62 65 72 20 6f 66 20 66 72 61 67 6d 65 6e 74 65 ber of fragmente
57b0: 64 20 66 72 65 65 20 62 79 74 65 73 20 77 69 74 d free bytes wit
57c0: 68 69 6e 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e hin the cell con
57d0: 74 65 6e 74 20 61 72 65 61 0a 3c 74 72 3e 3c 74 tent area.<tr><t
57e0: 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 d align=center v
57f0: 61 6c 69 67 6e 3d 74 6f 70 3e 38 3c 74 64 20 61 align=top>8<td a
5800: 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 lign=center vali
5810: 67 6e 3d 74 6f 70 3e 34 3c 74 64 20 61 6c 69 67 gn=top>4<td alig
5820: 6e 3d 6c 65 66 74 3e 0a 54 68 65 20 72 69 67 68 n=left>.The righ
5830: 74 2d 6d 6f 73 74 20 70 6f 69 6e 74 65 72 20 28 t-most pointer (
5840: 69 6e 74 65 72 69 6f 72 20 62 2d 74 72 65 65 20 interior b-tree
5850: 70 61 67 65 73 20 6f 6e 6c 79 29 0a 3c 2f 74 61 pages only).</ta
5860: 62 6c 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 ble></blockquote
5870: 3e 3c 2f 63 65 6e 74 65 72 3e 0a 0a 3c 70 3e 54 ></center>..<p>T
5880: 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 he cell pointer
5890: 61 72 72 61 79 20 6f 66 20 61 20 62 2d 74 72 65 array of a b-tre
58a0: 65 20 70 61 67 65 20 69 6d 6d 65 64 69 61 74 65 e page immediate
58b0: 6c 79 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20 62 ly follows the b
58c0: 2d 74 72 65 65 0a 70 61 67 65 20 68 65 61 64 65 -tree.page heade
58d0: 72 2e 20 20 4c 65 74 20 4b 20 62 65 20 74 68 65 r. Let K be the
58e0: 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 number of cells
58f0: 20 6f 6e 20 74 68 65 20 62 74 72 65 65 2e 20 20 on the btree.
5900: 54 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 The cell pointer
5910: 0a 61 72 72 61 79 20 63 6f 6e 73 69 73 74 73 20 .array consists
5920: 6f 66 20 4b 20 32 2d 62 79 74 65 20 69 6e 74 65 of K 2-byte inte
5930: 67 65 72 20 6f 66 66 73 65 74 73 20 74 6f 20 74 ger offsets to t
5940: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 73 he cell contents
5950: 2e 20 20 54 68 65 0a 63 65 6c 6c 20 70 6f 69 6e . The.cell poin
5960: 74 65 72 73 20 61 72 65 20 61 72 72 61 6e 67 65 ters are arrange
5970: 64 20 69 6e 20 6b 65 79 20 6f 72 64 65 72 20 77 d in key order w
5980: 69 74 68 20 6c 65 66 74 2d 6d 6f 73 74 20 63 65 ith left-most ce
5990: 6c 6c 20 28 74 68 65 20 63 65 6c 6c 20 77 69 74 ll (the cell wit
59a0: 68 20 74 68 65 0a 73 6d 61 6c 6c 65 73 74 20 6b h the.smallest k
59b0: 65 79 29 20 66 69 72 73 74 20 61 6e 64 20 74 68 ey) first and th
59c0: 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 63 65 6c e right-most cel
59d0: 6c 20 28 74 68 65 20 63 65 6c 6c 20 77 69 74 68 l (the cell with
59e0: 20 74 68 65 20 6c 61 72 67 65 73 74 0a 6b 65 79 the largest.key
59f0: 29 20 6c 61 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e ) last.</p>..<p>
5a00: 43 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 73 20 Cell content is
5a10: 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63 65 stored in the ce
5a20: 6c 6c 20 63 6f 6e 74 65 6e 74 20 72 65 67 69 6f ll content regio
5a30: 6e 20 6f 66 20 74 68 65 20 62 2d 74 72 65 65 20 n of the b-tree
5a40: 70 61 67 65 2e 0a 53 51 4c 69 74 65 20 73 74 72 page..SQLite str
5a50: 69 76 65 73 20 74 6f 20 70 6c 61 63 65 20 63 65 ives to place ce
5a60: 6c 6c 73 20 61 73 20 66 61 72 20 74 6f 77 61 72 lls as far towar
5a70: 64 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 d the end of the
5a80: 20 62 2d 74 72 65 65 20 70 61 67 65 20 61 73 0a b-tree page as.
5a90: 69 74 20 63 61 6e 2c 20 69 6e 20 6f 72 64 65 72 it can, in order
5aa0: 20 74 6f 20 6c 65 61 76 65 20 73 70 61 63 65 20 to leave space
5ab0: 66 6f 72 20 66 75 74 75 72 65 20 67 72 6f 77 74 for future growt
5ac0: 68 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 70 6f h of the cell po
5ad0: 69 6e 74 65 72 20 61 72 72 61 79 2e 0a 54 68 65 inter array..The
5ae0: 20 61 72 65 61 20 69 6e 20 62 65 74 77 65 65 6e area in between
5af0: 20 74 68 65 20 6c 61 73 74 20 63 65 6c 6c 20 70 the last cell p
5b00: 6f 69 6e 74 65 72 20 61 72 72 61 79 20 65 6e 74 ointer array ent
5b10: 72 79 20 61 6e 64 20 74 68 65 20 62 65 67 69 6e ry and the begin
5b20: 6e 69 6e 67 20 6f 66 0a 74 68 65 20 66 69 72 73 ning of.the firs
5b30: 74 20 63 65 6c 6c 20 69 73 20 74 68 65 20 75 6e t cell is the un
5b40: 61 6c 6c 6f 63 61 74 65 64 20 72 65 67 69 6f 6e allocated region
5b50: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 66 72 65 ..</p>..<p>A fre
5b60: 65 62 6c 6f 63 6b 20 69 73 20 61 20 73 74 72 75 eblock is a stru
5b70: 63 74 75 72 65 20 75 73 65 64 20 74 6f 20 69 64 cture used to id
5b80: 65 6e 74 69 66 79 20 75 6e 61 6c 6c 6f 63 61 74 entify unallocat
5b90: 65 64 20 73 70 61 63 65 20 77 69 74 68 69 6e 0a ed space within.
5ba0: 61 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 20 a b-tree page.
5bb0: 46 72 65 65 62 6c 6f 63 6b 73 20 61 72 65 20 6f Freeblocks are o
5bc0: 72 67 61 6e 69 7a 65 64 20 6f 6e 20 61 20 63 68 rganized on a ch
5bd0: 61 69 6e 2e 20 20 54 68 65 20 66 69 72 73 74 20 ain. The first
5be0: 32 20 62 79 74 65 73 20 6f 66 0a 61 20 66 72 65 2 bytes of.a fre
5bf0: 65 62 6c 6f 63 6b 20 61 72 65 20 61 20 62 69 67 eblock are a big
5c00: 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 -endian integer
5c10: 77 68 69 63 68 20 69 73 20 74 68 65 20 6f 66 66 which is the off
5c20: 73 65 74 20 69 6e 20 74 68 65 20 62 2d 74 72 65 set in the b-tre
5c30: 65 20 70 61 67 65 0a 6f 66 20 74 68 65 20 6e 65 e page.of the ne
5c40: 78 74 20 66 72 65 65 62 6c 6f 63 6b 20 69 6e 20 xt freeblock in
5c50: 74 68 65 20 63 68 61 69 6e 2c 20 6f 72 20 7a 65 the chain, or ze
5c60: 72 6f 20 69 66 20 74 68 65 20 66 72 65 65 62 6c ro if the freebl
5c70: 6f 63 6b 20 69 73 20 74 68 65 20 6c 61 73 74 20 ock is the last
5c80: 6f 6e 0a 74 68 65 20 63 68 61 69 6e 2e 20 20 54 on.the chain. T
5c90: 68 65 20 74 68 69 72 64 20 61 6e 64 20 66 6f 75 he third and fou
5ca0: 72 74 68 20 62 79 74 65 73 20 6f 66 20 65 61 63 rth bytes of eac
5cb0: 68 20 66 72 65 65 62 6c 6f 63 6b 20 66 6f 72 6d h freeblock form
5cc0: 0a 61 20 62 69 74 2d 65 6e 64 69 61 6e 20 69 6e .a bit-endian in
5cd0: 74 65 67 65 72 73 20 77 68 69 63 68 20 69 73 20 tegers which is
5ce0: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
5cf0: 66 72 65 65 62 6c 6f 63 6b 20 69 6e 20 62 79 74 freeblock in byt
5d00: 65 73 2c 20 69 6e 63 6c 75 64 69 6e 67 0a 74 68 es, including.th
5d10: 65 20 34 2d 62 79 74 65 20 68 65 61 64 65 72 2e e 4-byte header.
5d20: 20 20 46 72 65 65 62 6c 6f 63 6b 73 20 61 72 65 Freeblocks are
5d30: 20 61 6c 77 61 79 73 20 63 6f 6e 6e 65 63 74 65 always connecte
5d40: 64 20 69 6e 20 6f 72 64 65 72 20 0a 6f 66 20 69 d in order .of i
5d50: 6e 63 72 65 61 73 69 6e 67 20 6f 66 66 73 65 74 ncreasing offset
5d60: 2e 20 20 54 68 65 20 73 65 63 6f 6e 64 20 66 69 . The second fi
5d70: 65 6c 64 20 6f 66 20 74 68 65 20 62 2d 74 72 65 eld of the b-tre
5d80: 65 20 70 61 67 65 20 68 65 61 64 65 72 20 69 73 e page header is
5d90: 20 74 68 65 0a 6f 66 66 73 65 74 20 6f 66 20 74 the.offset of t
5da0: 68 65 20 66 69 72 73 74 20 66 72 65 65 62 6c 6f he first freeblo
5db0: 63 6b 2c 20 6f 72 20 7a 65 72 6f 20 69 66 20 74 ck, or zero if t
5dc0: 68 65 72 65 20 61 72 65 20 6e 6f 20 66 72 65 65 here are no free
5dd0: 62 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 0a 70 61 blocks on the.pa
5de0: 67 65 2e 20 20 49 6e 20 61 20 77 65 6c 6c 2d 66 ge. In a well-f
5df0: 6f 72 6d 65 64 20 62 2d 74 72 65 65 20 70 61 67 ormed b-tree pag
5e00: 65 2c 20 74 68 65 72 65 20 77 69 6c 6c 20 61 6c e, there will al
5e10: 77 61 79 73 20 62 65 20 61 74 20 6c 65 61 73 74 ways be at least
5e20: 20 6f 6e 65 20 63 65 6c 6c 0a 62 65 66 6f 72 65 one cell.before
5e30: 20 74 68 65 20 66 69 72 73 74 20 66 72 65 65 62 the first freeb
5e40: 6c 6f 63 6b 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 lock.</p>..<p>A
5e50: 66 72 65 65 62 6c 6f 63 6b 20 72 65 71 75 69 72 freeblock requir
5e60: 65 73 20 61 74 20 6c 65 61 73 74 20 34 20 62 79 es at least 4 by
5e70: 74 65 73 20 6f 66 20 73 70 61 63 65 2e 20 20 49 tes of space. I
5e80: 66 20 74 68 65 72 65 20 69 73 20 61 6e 20 69 73 f there is an is
5e90: 6f 6c 61 74 65 64 0a 67 72 6f 75 70 20 6f 66 20 olated.group of
5ea0: 31 2c 20 32 2c 20 6f 72 20 33 20 75 6e 75 73 65 1, 2, or 3 unuse
5eb0: 64 20 62 79 74 65 73 20 77 69 74 68 69 6e 20 74 d bytes within t
5ec0: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
5ed0: 61 72 65 61 2c 20 74 68 6f 73 65 20 62 79 74 65 area, those byte
5ee0: 73 0a 63 6f 6d 70 72 69 73 65 20 61 20 66 72 61 s.comprise a fra
5ef0: 67 6d 65 6e 74 2e 20 20 54 68 65 20 74 6f 74 61 gment. The tota
5f00: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 l number of byte
5f10: 73 20 69 6e 20 61 6c 6c 20 66 72 61 67 6d 65 6e s in all fragmen
5f20: 74 73 20 69 73 20 73 74 6f 72 65 64 0a 69 6e 20 ts is stored.in
5f30: 74 68 65 20 66 69 66 74 68 20 66 69 65 6c 64 20 the fifth field
5f40: 6f 66 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 of the b-tree pa
5f50: 67 65 20 68 65 61 64 65 72 2e 20 20 49 6e 20 61 ge header. In a
5f60: 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 62 2d 74 well-formed b-t
5f70: 72 65 65 20 70 61 67 65 2c 0a 74 68 65 20 74 6f ree page,.the to
5f80: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 tal number of by
5f90: 74 65 73 20 69 6e 20 66 72 61 67 6d 65 6e 74 73 tes in fragments
5fa0: 20 6d 61 79 20 6e 6f 74 20 65 78 63 65 65 64 20 may not exceed
5fb0: 36 30 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 60.</p>..<p>The
5fc0: 74 6f 74 61 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 total amount of
5fd0: 66 72 65 65 20 73 70 61 63 65 20 6f 6e 20 61 20 free space on a
5fe0: 62 2d 74 72 65 65 20 70 61 67 65 20 63 6f 6e 73 b-tree page cons
5ff0: 69 73 74 73 20 6f 66 20 74 68 65 20 73 69 7a 65 ists of the size
6000: 0a 6f 66 20 74 68 65 20 75 6e 61 6c 6c 6f 63 61 .of the unalloca
6010: 74 65 64 20 72 65 67 69 6f 6e 20 70 6c 75 73 20 ted region plus
6020: 74 68 65 20 74 6f 74 61 6c 20 73 69 7a 65 20 6f the total size o
6030: 66 20 61 6c 6c 20 66 72 65 65 62 6c 6f 63 6b 73 f all freeblocks
6040: 20 70 6c 75 73 20 74 68 65 0a 6e 75 6d 62 65 72 plus the.number
6050: 20 6f 66 20 66 72 61 67 6d 65 6e 74 65 64 20 66 of fragmented f
6060: 72 65 65 20 62 79 74 65 73 2e 20 20 53 51 4c 69 ree bytes. SQLi
6070: 74 65 20 6d 61 79 20 66 72 6f 6d 20 74 69 6d 65 te may from time
6080: 20 74 6f 20 74 69 6d 65 20 72 65 6f 72 67 61 6e to time reorgan
6090: 69 7a 65 0a 61 20 62 2d 74 72 65 65 20 70 61 67 ize.a b-tree pag
60a0: 65 20 73 6f 20 74 68 61 74 20 74 68 65 72 65 20 e so that there
60b0: 61 72 65 20 6e 6f 20 66 72 65 65 62 6c 6f 63 6b are no freeblock
60c0: 73 20 6f 72 20 66 72 61 67 6d 65 6e 74 20 62 79 s or fragment by
60d0: 74 65 73 2c 20 61 6c 6c 0a 75 6e 75 73 65 64 20 tes, all.unused
60e0: 62 79 74 65 73 20 61 72 65 20 63 6f 6e 74 61 69 bytes are contai
60f0: 6e 65 64 20 69 6e 20 74 68 65 20 75 6e 61 6c 6c ned in the unall
6100: 6f 63 61 74 65 64 20 73 70 61 63 65 20 72 65 67 ocated space reg
6110: 69 6f 6e 2c 20 61 6e 64 20 61 6c 6c 0a 63 65 6c ion, and all.cel
6120: 6c 73 20 61 72 65 20 70 61 63 6b 65 64 20 74 69 ls are packed ti
6130: 67 68 74 6c 79 20 61 74 20 74 68 65 20 65 6e 64 ghtly at the end
6140: 20 6f 66 20 74 68 65 20 70 61 67 65 2e 20 20 54 of the page. T
6150: 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 0a 22 his is called ."
6160: 64 65 66 72 61 67 6d 65 6e 74 69 6e 67 22 20 74 defragmenting" t
6170: 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 2e 3c he b-tree page.<
6180: 2f 70 3e 0a 0a 3c 74 63 6c 3e 68 64 5f 66 72 61 /p>..<tcl>hd_fra
6190: 67 6d 65 6e 74 20 76 61 72 69 6e 74 20 7b 76 61 gment varint {va
61a0: 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e riable-length in
61b0: 74 65 67 65 72 7d 20 7b 76 61 72 69 6e 74 7d 3c teger} {varint}<
61c0: 2f 74 63 6c 3e 0a 0a 3c 70 3e 41 20 76 61 72 69 /tcl>..<p>A vari
61d0: 61 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74 65 able-length inte
61e0: 67 65 72 20 6f 72 20 22 76 61 72 69 6e 74 22 20 ger or "varint"
61f0: 69 73 20 61 20 73 74 61 74 69 63 20 48 75 66 66 is a static Huff
6200: 6d 61 6e 20 65 6e 63 6f 64 69 6e 67 0a 6f 66 20 man encoding.of
6210: 36 34 2d 62 69 74 20 74 77 6f 73 2d 63 6f 6d 70 64-bit twos-comp
6220: 6c 65 6d 65 6e 74 20 69 6e 74 65 67 65 72 73 20 lement integers
6230: 74 68 61 74 20 75 73 65 73 20 6c 65 73 73 20 73 that uses less s
6240: 70 61 63 65 20 66 6f 72 20 73 6d 61 6c 6c 20 70 pace for small p
6250: 6f 73 69 74 69 76 65 20 0a 76 61 6c 75 65 73 2e ositive .values.
6260: 20 0a 41 20 76 61 72 69 6e 74 20 69 73 20 62 65 .A varint is be
6270: 74 77 65 65 6e 20 31 20 61 6e 64 20 39 20 62 79 tween 1 and 9 by
6280: 74 65 73 20 69 6e 20 6c 65 6e 67 74 68 2e 20 20 tes in length.
6290: 54 68 65 20 76 61 72 69 6e 74 20 63 6f 6e 73 69 The varint consi
62a0: 73 74 73 20 6f 66 20 65 69 74 68 65 72 0a 7a 65 sts of either.ze
62b0: 72 6f 20 6f 72 20 6d 6f 72 65 20 62 79 74 65 20 ro or more byte
62c0: 77 68 69 63 68 20 68 61 76 65 20 74 68 65 20 68 which have the h
62d0: 69 67 68 2d 6f 72 64 65 72 20 62 69 74 20 73 65 igh-order bit se
62e0: 74 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 t followed by a
62f0: 73 69 6e 67 6c 65 20 62 79 74 65 0a 77 69 74 68 single byte.with
6300: 20 74 68 65 20 68 69 67 68 2d 6f 72 64 65 72 20 the high-order
6310: 62 69 74 20 63 6c 65 61 72 2c 20 6f 72 20 6e 69 bit clear, or ni
6320: 6e 65 20 62 79 74 65 73 2c 20 77 68 69 63 68 65 ne bytes, whiche
6330: 76 65 72 20 69 73 20 73 68 6f 72 74 65 72 2e 0a ver is shorter..
6340: 54 68 65 20 6c 6f 77 65 72 20 73 65 76 65 6e 20 The lower seven
6350: 62 69 74 73 20 6f 66 20 65 61 63 68 20 6f 66 20 bits of each of
6360: 74 68 65 20 66 69 72 73 74 20 65 69 67 68 74 20 the first eight
6370: 62 79 74 65 73 20 61 6e 64 20 61 6c 6c 20 38 20 bytes and all 8
6380: 62 69 74 73 20 6f 66 0a 74 68 65 20 6e 69 6e 74 bits of.the nint
6390: 68 20 62 79 74 65 20 61 72 65 20 75 73 65 64 20 h byte are used
63a0: 74 6f 20 72 65 63 6f 6e 73 74 72 75 63 74 20 74 to reconstruct t
63b0: 68 65 20 36 34 2d 62 69 74 20 74 77 6f 73 2d 63 he 64-bit twos-c
63c0: 6f 6d 70 6c 65 6d 65 6e 74 20 69 6e 74 65 67 65 omplement intege
63d0: 72 2e 0a 56 61 72 69 6e 74 73 20 61 72 65 20 62 r..Varints are b
63e0: 69 67 2d 65 6e 64 69 61 6e 3a 20 62 69 74 73 20 ig-endian: bits
63f0: 74 61 6b 65 6e 20 66 72 6f 6d 20 74 68 65 20 65 taken from the e
6400: 61 72 6c 69 65 72 20 62 79 74 65 20 6f 66 20 74 arlier byte of t
6410: 68 65 20 76 61 72 69 6e 74 0a 61 72 65 20 74 68 he varint.are th
6420: 65 20 6d 6f 72 65 20 73 69 67 6e 69 66 69 63 61 e more significa
6430: 6e 74 20 61 6e 64 20 62 69 74 73 20 74 61 6b 65 nt and bits take
6440: 6e 20 66 72 6f 6d 20 74 68 65 20 6c 61 74 65 72 n from the later
6450: 20 62 79 74 65 73 2e 20 3c 2f 70 3e 0a 0a 3c 70 bytes. </p>..<p
6460: 3e 54 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 61 >The format of a
6470: 20 63 65 6c 6c 20 64 65 70 65 6e 64 73 20 6f 6e cell depends on
6480: 20 77 68 69 63 68 20 6b 69 6e 64 20 6f 66 20 62 which kind of b
6490: 2d 74 72 65 65 20 70 61 67 65 20 74 68 65 20 63 -tree page the c
64a0: 65 6c 6c 0a 61 70 70 65 61 72 73 20 6f 6e 2e 20 ell.appears on.
64b0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 The following t
64c0: 61 62 6c 65 20 73 68 6f 77 73 20 74 68 65 20 65 able shows the e
64d0: 6c 65 6d 65 6e 74 73 20 6f 66 20 61 20 63 65 6c lements of a cel
64e0: 6c 2c 20 69 6e 0a 6f 72 64 65 72 20 6f 66 20 61 l, in.order of a
64f0: 70 70 65 61 72 61 6e 63 65 2c 20 66 6f 72 20 74 ppearance, for t
6500: 68 65 20 76 61 72 69 6f 75 73 20 62 2d 74 72 65 he various b-tre
6510: 65 20 70 61 67 65 20 74 79 70 65 73 2e 3c 2f 70 e page types.</p
6520: 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c >..<blockquote><
6530: 64 6c 3e 0a 3c 64 74 3e 3c 70 3e 54 61 62 6c 65 dl>.<dt><p>Table
6540: 20 42 2d 54 72 65 65 20 4c 65 61 66 20 43 65 6c B-Tree Leaf Cel
6550: 6c 3a 3c 2f 70 3e 3c 2f 64 74 3e 0a 3c 64 64 3e l:</p></dt>.<dd>
6560: 3c 70 3e 3c 75 6c 3e 0a 3c 6c 69 3e 41 20 76 61 <p><ul>.<li>A va
6570: 72 69 6e 74 20 77 68 69 63 68 20 69 73 20 74 68 rint which is th
6580: 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f e total number o
6590: 66 20 62 79 74 65 73 20 6f 66 20 70 61 79 6c 6f f bytes of paylo
65a0: 61 64 2c 20 69 6e 63 6c 75 64 69 6e 67 20 61 6e ad, including an
65b0: 79 0a 6f 76 65 72 66 6c 6f 77 0a 3c 6c 69 3e 41 y.overflow.<li>A
65c0: 20 76 61 72 69 6e 74 20 77 68 69 63 68 20 69 73 varint which is
65d0: 20 74 68 65 20 69 6e 74 65 67 65 72 20 6b 65 79 the integer key
65e0: 2c 20 61 2e 6b 2e 61 2e 20 22 72 6f 77 69 64 22 , a.k.a. "rowid"
65f0: 0a 3c 6c 69 3e 54 68 65 20 69 6e 69 74 69 61 6c .<li>The initial
6600: 20 70 6f 72 74 69 6f 6e 20 6f 66 20 74 68 65 20 portion of the
6610: 70 61 79 6c 6f 61 64 20 74 68 61 74 20 64 6f 65 payload that doe
6620: 73 20 6e 6f 74 20 73 70 69 6c 6c 20 74 6f 20 6f s not spill to o
6630: 76 65 72 66 6c 6f 77 0a 70 61 67 65 73 2e 0a 3c verflow.pages..<
6640: 6c 69 3e 41 20 34 2d 62 79 74 65 20 62 69 67 2d li>A 4-byte big-
6650: 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 70 endian integer p
6660: 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 age number for t
6670: 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 he first page of
6680: 20 74 68 65 0a 6f 76 65 72 66 6c 6f 77 20 70 61 the.overflow pa
6690: 67 65 20 6c 69 73 74 20 2d 20 6f 6d 69 74 74 65 ge list - omitte
66a0: 64 20 69 66 20 61 6c 6c 20 70 61 79 6c 6f 61 64 d if all payload
66b0: 20 66 69 74 73 20 6f 6e 20 74 68 65 20 62 2d 74 fits on the b-t
66c0: 72 65 65 20 70 61 67 65 2e 0a 3c 2f 75 6c 3e 3c ree page..</ul><
66d0: 2f 70 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 70 /p></dd>..<dt><p
66e0: 3e 54 61 62 6c 65 20 42 2d 54 72 65 65 20 49 6e >Table B-Tree In
66f0: 74 65 72 69 6f 72 20 43 65 6c 6c 3a 3c 2f 70 3e terior Cell:</p>
6700: 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e 3c 75 6c </dt>.<dd><p><ul
6710: 3e 0a 3c 6c 69 3e 41 20 34 2d 62 79 74 65 20 62 >.<li>A 4-byte b
6720: 69 67 2d 65 6e 64 69 6e 67 20 70 61 67 65 20 6e ig-ending page n
6730: 75 6d 62 65 72 20 77 68 69 63 68 20 69 73 20 74 umber which is t
6740: 68 65 20 6c 65 66 74 20 63 68 69 6c 64 20 70 6f he left child po
6750: 69 6e 74 65 72 2e 0a 3c 6c 69 3e 41 20 76 61 72 inter..<li>A var
6760: 69 6e 74 20 77 68 69 63 68 20 69 73 20 74 68 65 int which is the
6770: 20 69 6e 74 65 67 65 72 20 6b 65 79 0a 3c 2f 75 integer key.</u
6780: 6c 3e 3c 2f 70 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 l></p></dd>..<dt
6790: 3e 3c 70 3e 49 6e 64 65 78 20 42 2d 54 72 65 65 ><p>Index B-Tree
67a0: 20 4c 65 61 66 20 43 65 6c 6c 3a 3c 2f 70 3e 3c Leaf Cell:</p><
67b0: 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e 3c 75 6c 3e /dt>.<dd><p><ul>
67c0: 0a 3c 6c 69 3e 41 20 76 61 72 69 6e 74 20 77 68 .<li>A varint wh
67d0: 69 63 68 20 69 73 20 74 68 65 20 74 6f 74 61 6c ich is the total
67e0: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
67f0: 20 6f 66 20 6b 65 79 20 70 61 79 6c 6f 61 64 2c of key payload,
6800: 20 69 6e 63 6c 75 64 69 6e 67 20 61 6e 79 0a 6f including any.o
6810: 76 65 72 66 6c 6f 77 0a 3c 6c 69 3e 54 68 65 20 verflow.<li>The
6820: 69 6e 69 74 69 61 6c 20 70 6f 72 74 69 6f 6e 20 initial portion
6830: 6f 66 20 74 68 65 20 70 61 79 6c 6f 61 64 20 74 of the payload t
6840: 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 73 70 69 hat does not spi
6850: 6c 6c 20 74 6f 20 6f 76 65 72 66 6c 6f 77 0a 70 ll to overflow.p
6860: 61 67 65 73 2e 0a 3c 6c 69 3e 41 20 34 2d 62 79 ages..<li>A 4-by
6870: 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e te big-endian in
6880: 74 65 67 65 72 20 70 61 67 65 20 6e 75 6d 62 65 teger page numbe
6890: 72 20 66 6f 72 20 74 68 65 20 66 69 72 73 74 20 r for the first
68a0: 70 61 67 65 20 6f 66 20 74 68 65 0a 6f 76 65 72 page of the.over
68b0: 66 6c 6f 77 20 70 61 67 65 20 6c 69 73 74 20 2d flow page list -
68c0: 20 6f 6d 69 74 74 65 64 20 69 66 20 61 6c 6c 20 omitted if all
68d0: 70 61 79 6c 6f 61 64 20 66 69 74 73 20 6f 6e 20 payload fits on
68e0: 74 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 2e the b-tree page.
68f0: 0a 3c 2f 75 6c 3e 3c 2f 70 3e 3c 2f 64 64 3e 0a .</ul></p></dd>.
6900: 0a 3c 64 74 3e 3c 70 3e 49 6e 64 65 78 20 42 2d .<dt><p>Index B-
6910: 54 72 65 65 20 49 6e 74 65 72 69 6f 72 20 43 65 Tree Interior Ce
6920: 6c 6c 3a 3c 2f 70 3e 3c 2f 64 74 3e 0a 3c 64 64 ll:</p></dt>.<dd
6930: 3e 3c 70 3e 3c 75 6c 3e 0a 3c 6c 69 3e 41 20 34 ><p><ul>.<li>A 4
6940: 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 6e 67 -byte big-ending
6950: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 77 68 69 page number whi
6960: 63 68 20 69 73 20 74 68 65 20 6c 65 66 74 20 63 ch is the left c
6970: 68 69 6c 64 20 70 6f 69 6e 74 65 72 2e 0a 3c 6c hild pointer..<l
6980: 69 3e 41 20 76 61 72 69 6e 74 20 77 68 69 63 68 i>A varint which
6990: 20 69 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 is the total nu
69a0: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 mber of bytes of
69b0: 20 6b 65 79 20 70 61 79 6c 6f 61 64 2c 20 69 6e key payload, in
69c0: 63 6c 75 64 69 6e 67 20 61 6e 79 0a 6f 76 65 72 cluding any.over
69d0: 66 6c 6f 77 0a 3c 6c 69 3e 54 68 65 20 69 6e 69 flow.<li>The ini
69e0: 74 69 61 6c 20 70 6f 72 74 69 6f 6e 20 6f 66 20 tial portion of
69f0: 74 68 65 20 70 61 79 6c 6f 61 64 20 74 68 61 74 the payload that
6a00: 20 64 6f 65 73 20 6e 6f 74 20 73 70 69 6c 6c 20 does not spill
6a10: 74 6f 20 6f 76 65 72 66 6c 6f 77 0a 70 61 67 65 to overflow.page
6a20: 73 2e 0a 3c 6c 69 3e 41 20 34 2d 62 79 74 65 20 s..<li>A 4-byte
6a30: 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 big-endian integ
6a40: 65 72 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66 er page number f
6a50: 6f 72 20 74 68 65 20 66 69 72 73 74 20 70 61 67 or the first pag
6a60: 65 20 6f 66 20 74 68 65 0a 6f 76 65 72 66 6c 6f e of the.overflo
6a70: 77 20 70 61 67 65 20 6c 69 73 74 20 2d 20 6f 6d w page list - om
6a80: 69 74 74 65 64 20 69 66 20 61 6c 6c 20 70 61 79 itted if all pay
6a90: 6c 6f 61 64 20 66 69 74 73 20 6f 6e 20 74 68 65 load fits on the
6aa0: 20 62 2d 74 72 65 65 20 70 61 67 65 2e 0a 3c 2f b-tree page..</
6ab0: 75 6c 3e 3c 2f 70 3e 3c 2f 64 64 3e 0a 3c 2f 64 ul></p></dd>.</d
6ac0: 6c 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a l></blockquote>.
6ad0: 0a 3c 70 3e 54 68 65 20 69 6e 66 6f 72 6d 61 74 .<p>The informat
6ae0: 69 6f 6e 20 61 62 6f 76 65 20 63 61 6e 20 62 65 ion above can be
6af0: 20 72 65 63 61 73 74 20 69 6e 74 6f 20 61 20 74 recast into a t
6b00: 61 62 6c 65 20 66 6f 72 6d 61 74 20 61 73 20 66 able format as f
6b10: 6f 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 0a 3c 74 63 ollows:</p>..<tc
6b20: 6c 3e 68 64 5f 66 72 61 67 6d 65 6e 74 20 63 65 l>hd_fragment ce
6b30: 6c 6c 66 6f 72 6d 61 74 20 7b 63 65 6c 6c 20 66 llformat {cell f
6b40: 6f 72 6d 61 74 20 73 75 6d 6d 61 72 79 7d 3c 2f ormat summary}</
6b50: 74 63 6c 3e 0a 3c 63 65 6e 74 65 72 3e 0a 3c 69 tcl>.<center>.<i
6b60: 3e 42 2d 74 72 65 65 20 43 65 6c 6c 20 46 6f 72 >B-tree Cell For
6b70: 6d 61 74 3c 2f 69 3e 0a 3c 74 61 62 6c 65 20 62 mat</i>.<table b
6b80: 6f 72 64 65 72 3d 31 20 77 69 64 74 68 3d 22 38 order=1 width="8
6b90: 30 25 22 3e 0a 3c 74 72 3e 3c 74 68 20 72 6f 77 0%">.<tr><th row
6ba0: 73 70 61 6e 3d 32 3e 44 61 74 61 74 79 70 65 0a span=2>Datatype.
6bb0: 20 20 20 20 3c 74 68 20 63 6f 6c 73 70 61 6e 3d <th colspan=
6bc0: 34 3e 41 70 70 65 61 72 73 20 69 6e 2e 2e 2e 0a 4>Appears in....
6bd0: 20 20 20 20 3c 74 68 20 72 6f 77 73 70 61 6e 3d <th rowspan=
6be0: 32 3e 44 65 73 63 72 69 70 74 69 6f 6e 0a 3c 74 2>Description.<t
6bf0: 72 3e 3c 74 68 3e 54 61 62 6c 65 20 4c 65 61 66 r><th>Table Leaf
6c00: 0a 20 20 20 20 3c 74 68 3e 54 61 62 6c 65 20 49 . <th>Table I
6c10: 6e 74 65 72 69 6f 72 0a 20 20 20 20 3c 74 68 3e nterior. <th>
6c20: 49 6e 64 65 78 20 4c 65 61 66 0a 20 20 20 20 3c Index Leaf. <
6c30: 74 68 3e 49 6e 64 65 78 20 49 6e 74 65 72 69 6f th>Index Interio
6c40: 72 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d r.<tr><td align=
6c50: 63 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f center valign=to
6c60: 70 3e 34 2d 62 79 74 65 20 69 6e 74 65 67 65 72 p>4-byte integer
6c70: 0a 20 20 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 . <td align=c
6c80: 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 enter valign=top
6c90: 3e 26 6e 62 73 70 3b 0a 20 20 20 20 3c 74 64 20 > . <td
6ca0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c align=center val
6cb0: 69 67 6e 3d 74 6f 70 3e 26 23 78 32 37 31 34 3b ign=top>✔
6cc0: 0a 20 20 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 . <td align=c
6cd0: 65 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 enter valign=top
6ce0: 3e 26 6e 62 73 70 3b 0a 20 20 20 20 3c 74 64 20 > . <td
6cf0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c align=center val
6d00: 69 67 6e 3d 74 6f 70 3e 26 23 78 32 37 31 34 3b ign=top>✔
6d10: 0a 20 20 20 20 3c 74 64 20 61 6c 69 67 6e 3d 6c . <td align=l
6d20: 65 66 74 3e 50 61 67 65 20 6e 75 6d 62 65 72 20 eft>Page number
6d30: 6f 66 20 6c 65 66 74 20 63 68 69 6c 64 0a 3c 74 of left child.<t
6d40: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 r><td align=cent
6d50: 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 76 61 er valign=top>va
6d60: 72 69 6e 74 0a 20 20 20 20 3c 74 64 20 61 6c 69 rint. <td ali
6d70: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
6d80: 3d 74 6f 70 3e 26 23 78 32 37 31 34 3b 0a 20 20 =top>✔.
6d90: 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 <td align=cent
6da0: 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 26 6e er valign=top>&n
6db0: 62 73 70 3b 0a 20 20 20 20 3c 74 64 20 61 6c 69 bsp;. <td ali
6dc0: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
6dd0: 3d 74 6f 70 3e 26 23 78 32 37 31 34 3b 0a 20 20 =top>✔.
6de0: 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 <td align=cent
6df0: 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 26 23 er valign=top>&#
6e00: 78 32 37 31 34 3b 0a 20 20 20 20 3c 74 64 20 61 x2714;. <td a
6e10: 6c 69 67 6e 3d 6c 65 66 74 3e 4e 75 6d 62 65 72 lign=left>Number
6e20: 20 6f 66 20 62 79 74 65 73 20 6f 66 20 70 61 79 of bytes of pay
6e30: 6c 6f 61 64 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 load.<tr><td ali
6e40: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
6e50: 3d 74 6f 70 3e 76 61 72 69 6e 74 0a 20 20 20 20 =top>varint.
6e60: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6e70: 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 26 23 78 32 valign=top>
6e80: 37 31 34 3b 0a 20 20 20 20 3c 74 64 20 61 6c 69 714;. <td ali
6e90: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
6ea0: 3d 74 6f 70 3e 26 23 78 32 37 31 34 3b 0a 20 20 =top>✔.
6eb0: 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 <td align=cent
6ec0: 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 26 6e er valign=top>&n
6ed0: 62 73 70 3b 0a 20 20 20 20 3c 74 64 20 61 6c 69 bsp;. <td ali
6ee0: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
6ef0: 3d 74 6f 70 3e 26 6e 62 73 70 3b 0a 20 20 20 20 =top> .
6f00: 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 52 <td align=left>R
6f10: 6f 77 69 64 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 owid.<tr><td ali
6f20: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
6f30: 3d 74 6f 70 3e 62 79 74 65 20 61 72 72 61 79 0a =top>byte array.
6f40: 20 20 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 65 <td align=ce
6f50: 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e nter valign=top>
6f60: 26 23 78 32 37 31 34 3b 0a 20 20 20 20 3c 74 64 ✔. <td
6f70: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 61 align=center va
6f80: 6c 69 67 6e 3d 74 6f 70 3e 26 6e 62 73 70 3b 0a lign=top> .
6f90: 20 20 20 20 3c 74 64 20 61 6c 69 67 6e 3d 63 65 <td align=ce
6fa0: 6e 74 65 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e nter valign=top>
6fb0: 26 23 78 32 37 31 34 3b 0a 20 20 20 20 3c 74 64 ✔. <td
6fc0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 61 align=center va
6fd0: 6c 69 67 6e 3d 74 6f 70 3e 26 23 78 32 37 31 34 lign=top>✔
6fe0: 3b 0a 20 20 20 20 3c 74 64 20 61 6c 69 67 6e 3d ;. <td align=
6ff0: 6c 65 66 74 3e 50 61 79 6c 6f 61 64 0a 3c 74 72 left>Payload.<tr
7000: 3e 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 ><td align=cente
7010: 72 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 34 2d 62 r valign=top>4-b
7020: 79 74 65 20 69 6e 74 65 67 65 72 0a 20 20 20 20 yte integer.
7030: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
7040: 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 26 23 78 32 valign=top>
7050: 37 31 34 3b 0a 20 20 20 20 3c 74 64 20 61 6c 69 714;. <td ali
7060: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
7070: 3d 74 6f 70 3e 26 6e 62 73 70 3b 0a 20 20 20 20 =top> .
7080: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
7090: 20 76 61 6c 69 67 6e 3d 74 6f 70 3e 26 23 78 32 valign=top>
70a0: 37 31 34 3b 0a 20 20 20 20 3c 74 64 20 61 6c 69 714;. <td ali
70b0: 67 6e 3d 63 65 6e 74 65 72 20 76 61 6c 69 67 6e gn=center valign
70c0: 3d 74 6f 70 3e 26 23 78 32 37 31 34 3b 0a 20 20 =top>✔.
70d0: 20 20 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 <td align=left
70e0: 3e 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 >Page number of
70f0: 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 first overflow p
7100: 61 67 65 0a 3c 2f 74 61 62 6c 65 3e 3c 2f 63 65 age.</table></ce
7110: 6e 74 65 72 3e 0a 0a 0a 0a 3c 74 72 3e 3c 74 64 nter>....<tr><td
7120: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 20 76 61 align=center va
7130: 6c 69 67 6e 3d 74 6f 70 3e 0a 0a 3c 70 3e 54 68 lign=top>..<p>Th
7140: 65 20 61 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c e amount of payl
7150: 6f 61 64 20 74 68 61 74 20 73 70 69 6c 6c 73 20 oad that spills
7160: 6f 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 onto overflow pa
7170: 67 65 73 20 61 6c 73 6f 20 64 65 70 65 6e 64 73 ges also depends
7180: 20 6f 6e 0a 74 68 65 20 70 61 67 65 20 74 79 70 on.the page typ
7190: 65 2e 20 20 46 6f 72 20 74 68 65 20 66 6f 6c 6c e. For the foll
71a0: 6f 77 69 6e 67 20 63 6f 6d 70 75 74 61 74 69 6f owing computatio
71b0: 6e 73 2c 20 6c 65 74 20 55 20 62 65 20 74 68 65 ns, let U be the
71c0: 20 75 73 61 62 6c 65 20 73 69 7a 65 0a 6f 66 20 usable size.of
71d0: 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2c a database page,
71e0: 20 74 68 65 20 74 6f 74 61 6c 20 70 61 67 65 20 the total page
71f0: 73 69 7a 65 20 6c 65 73 73 20 74 68 65 20 72 65 size less the re
7200: 73 65 72 76 65 64 20 73 70 61 63 65 20 61 74 20 served space at
7210: 74 68 65 0a 65 6e 64 20 6f 66 20 65 61 63 68 20 the.end of each
7220: 70 61 67 65 2e 20 20 41 6e 64 20 6c 65 74 20 50 page. And let P
7230: 20 62 65 20 74 68 65 20 70 61 79 6c 6f 61 64 20 be the payload
7240: 73 69 7a 65 2e 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 size.</p>..<bloc
7250: 6b 71 75 6f 74 65 3e 3c 64 6c 3e 0a 3c 64 74 3e kquote><dl>.<dt>
7260: 54 61 62 6c 65 20 42 2d 54 72 65 65 20 4c 65 61 Table B-Tree Lea
7270: 66 20 43 65 6c 6c 3a 3c 2f 64 74 3e 0a 3c 64 64 f Cell:</dt>.<dd
7280: 3e 3c 70 3e 0a 49 66 20 74 68 65 20 70 61 79 6c ><p>.If the payl
7290: 6f 61 64 20 73 69 7a 65 20 50 20 69 73 20 6c 65 oad size P is le
72a0: 73 73 20 74 68 61 6e 20 55 2d 33 36 20 74 68 65 ss than U-36 the
72b0: 6e 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 79 n the entire pay
72c0: 6c 6f 61 64 20 69 73 20 73 74 6f 72 65 64 0a 6f load is stored.o
72d0: 6e 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 67 n the b-tree pag
72e0: 65 2e 20 20 4c 65 74 20 4d 20 62 65 20 28 28 55 e. Let M be ((U
72f0: 2d 31 32 29 2a 33 32 2f 32 35 35 29 2d 32 33 2e -12)*32/255)-23.
7300: 20 20 49 66 20 50 20 69 73 20 67 72 65 61 74 65 If P is greate
7310: 72 20 74 68 61 6e 20 55 2d 33 35 0a 74 68 65 6e r than U-35.then
7320: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 the number of b
7330: 79 74 65 20 73 74 6f 72 65 64 20 6f 6e 20 74 68 yte stored on th
7340: 65 20 62 2d 74 72 65 65 20 70 61 67 65 20 69 73 e b-tree page is
7350: 20 74 68 65 20 6c 65 73 73 6f 72 20 6f 66 0a 4d the lessor of.M
7360: 2b 28 28 50 2d 4d 29 25 28 55 2d 34 29 29 20 61 +((P-M)%(U-4)) a
7370: 6e 64 20 55 2d 33 35 2e 0a 3c 2f 70 3e 3c 2f 64 nd U-35..</p></d
7380: 64 3e 0a 0a 3c 64 74 3e 54 61 62 6c 65 20 42 2d d>..<dt>Table B-
7390: 54 72 65 65 20 49 6e 74 65 72 69 6f 72 20 43 65 Tree Interior Ce
73a0: 6c 6c 3a 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e ll:</dt>.<dd><p>
73b0: 0a 49 6e 74 65 72 69 6f 72 20 70 61 67 65 73 20 .Interior pages
73c0: 6f 66 20 74 61 62 6c 65 20 62 2d 74 72 65 65 73 of table b-trees
73d0: 20 68 61 76 65 20 6e 6f 20 70 61 79 6c 6f 61 64 have no payload
73e0: 20 61 6e 64 20 73 6f 20 74 68 65 72 65 20 69 73 and so there is
73f0: 20 6e 65 76 65 72 0a 61 6e 79 20 70 61 79 6c 6f never.any paylo
7400: 61 64 20 74 6f 20 73 70 69 6c 6c 2e 0a 3c 2f 70 ad to spill..</p
7410: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 49 6e 64 65 ></dd>..<dt>Inde
7420: 78 20 42 2d 54 72 65 65 20 4c 65 61 66 20 4f 72 x B-Tree Leaf Or
7430: 20 49 6e 74 65 72 69 6f 72 20 43 65 6c 6c 3a 3c Interior Cell:<
7440: 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e 0a 49 66 20 /dt>.<dd><p>.If
7450: 74 68 65 20 70 61 79 6c 6f 61 64 20 73 69 7a 65 the payload size
7460: 20 50 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 P is less than
7470: 28 28 55 2d 31 32 29 2a 36 34 2f 32 35 35 29 2d ((U-12)*64/255)-
7480: 32 32 20 74 68 65 6e 20 74 68 65 20 65 6e 74 69 22 then the enti
7490: 72 65 0a 70 61 79 6c 6f 61 64 20 69 73 20 73 74 re.payload is st
74a0: 6f 72 65 64 20 6f 6e 20 74 68 65 20 62 2d 74 72 ored on the b-tr
74b0: 65 65 20 70 61 67 65 2e 20 20 0a 4c 65 74 20 4d ee page. .Let M
74c0: 20 62 65 20 28 28 55 2d 31 32 29 2a 33 32 2f 32 be ((U-12)*32/2
74d0: 35 35 29 2d 32 33 2e 20 20 49 66 20 50 20 69 73 55)-23. If P is
74e0: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 28 28 greater than ((
74f0: 55 2d 31 32 29 2a 36 34 2f 32 35 35 29 2d 32 33 U-12)*64/255)-23
7500: 0a 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 .then the number
7510: 20 6f 66 20 62 79 74 65 20 73 74 6f 72 65 64 20 of byte stored
7520: 6f 6e 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 on the b-tree pa
7530: 67 65 20 69 73 20 74 68 65 20 6c 65 73 73 6f 72 ge is the lessor
7540: 20 6f 66 0a 4d 2b 28 28 50 2d 4d 29 25 28 55 2d of.M+((P-M)%(U-
7550: 34 29 29 20 61 6e 64 20 28 28 55 2d 31 32 29 2a 4)) and ((U-12)*
7560: 36 34 2f 32 35 35 29 2d 32 33 2e 0a 3c 2f 70 3e 64/255)-23..</p>
7570: 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 3c 2f 62 6c 6f </dd>.</dl></blo
7580: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68 65 ckquote>..<p>The
7590: 20 6f 76 65 72 66 6c 6f 77 20 74 68 72 65 73 68 overflow thresh
75a0: 6f 6c 64 73 20 61 72 65 20 64 65 73 69 67 6e 65 olds are designe
75b0: 64 20 74 6f 20 67 69 76 65 20 61 20 6d 69 6e 69 d to give a mini
75c0: 6d 75 6d 20 66 61 6e 6f 75 74 20 6f 66 0a 34 20 mum fanout of.4
75d0: 66 6f 72 20 69 6e 64 65 78 20 62 2d 74 72 65 65 for index b-tree
75e0: 73 20 61 6e 64 20 74 6f 20 6d 61 6b 65 20 73 75 s and to make su
75f0: 72 65 20 65 6e 6f 75 67 68 20 6f 66 20 74 68 65 re enough of the
7600: 20 70 61 79 6c 6f 61 64 0a 69 73 20 6f 6e 20 74 payload.is on t
7610: 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 20 74 he b-tree page t
7620: 68 61 74 20 74 68 65 20 72 65 63 6f 72 64 20 68 hat the record h
7630: 65 61 64 65 72 20 63 61 6e 20 75 73 75 61 6c 6c eader can usuall
7640: 79 20 62 65 20 61 63 63 65 73 73 65 64 0a 77 69 y be accessed.wi
7650: 74 68 6f 75 74 20 63 6f 6e 73 75 6c 74 69 6e 67 thout consulting
7660: 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
7670: 65 2e 20 20 49 6e 20 68 69 6e 64 73 69 67 68 74 e. In hindsight
7680: 2c 20 74 68 65 20 64 65 73 69 67 6e 65 72 73 20 , the designers
7690: 6f 66 0a 74 68 65 20 53 51 4c 69 74 65 20 62 2d of.the SQLite b-
76a0: 74 72 65 65 20 6c 6f 67 69 63 20 72 65 61 6c 69 tree logic reali
76b0: 7a 65 20 74 68 61 74 20 74 68 65 73 65 20 74 68 ze that these th
76c0: 72 65 73 68 6f 6c 64 73 20 63 6f 75 6c 64 20 68 resholds could h
76d0: 61 76 65 20 62 65 65 6e 0a 6d 61 64 65 20 6d 75 ave been.made mu
76e0: 63 68 20 73 69 6d 70 6c 65 72 2e 20 20 48 6f 77 ch simpler. How
76f0: 65 76 65 72 2c 20 74 68 65 20 63 6f 6d 70 75 74 ever, the comput
7700: 61 74 69 6f 6e 73 20 63 61 6e 6e 6f 74 20 62 65 ations cannot be
7710: 20 6e 6f 77 20 62 65 20 63 68 61 6e 67 65 64 0a now be changed.
7720: 77 69 74 68 6f 75 74 20 72 65 73 75 6c 74 69 6e without resultin
7730: 67 20 69 6e 20 61 6e 20 69 6e 63 6f 6d 70 61 74 g in an incompat
7740: 69 62 6c 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 ible file format
7750: 2e 20 20 41 6e 64 20 74 68 65 20 63 75 72 72 65 . And the curre
7760: 6e 74 20 63 6f 6d 70 75 74 61 74 69 6f 6e 73 0a nt computations.
7770: 77 6f 72 6b 20 77 65 6c 6c 2c 20 65 76 65 6e 20 work well, even
7780: 69 66 20 74 68 65 79 20 61 72 65 20 61 20 6c 69 if they are a li
7790: 74 74 6c 65 20 63 6f 6d 70 6c 65 78 2e 3c 2f 70 ttle complex.</p
77a0: 3e 0a 0a 3c 68 33 3e 31 2e 36 20 43 65 6c 6c 20 >..<h3>1.6 Cell
77b0: 50 61 79 6c 6f 61 64 20 4f 76 65 72 66 6c 6f 77 Payload Overflow
77c0: 20 50 61 67 65 73 3c 2f 68 33 3e 0a 0a 3c 70 3e Pages</h3>..<p>
77d0: 57 68 65 6e 20 74 68 65 20 70 61 79 6c 6f 61 64 When the payload
77e0: 20 6f 66 20 61 20 62 2d 74 72 65 65 20 63 65 6c of a b-tree cel
77f0: 6c 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 20 66 l is too large f
7800: 6f 72 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 or the b-tree pa
7810: 67 65 2c 0a 74 68 65 20 73 75 72 70 6c 75 73 20 ge,.the surplus
7820: 69 73 20 73 70 69 6c 6c 65 64 20 6f 6e 74 6f 20 is spilled onto
7830: 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 overflow pages.
7840: 20 4f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 Overflow pages
7850: 66 6f 72 6d 20 61 20 6c 69 6e 6b 65 64 0a 6c 69 form a linked.li
7860: 73 74 2e 20 20 54 68 65 20 66 69 72 73 74 20 66 st. The first f
7870: 6f 75 72 20 62 79 74 65 73 20 6f 66 20 65 61 63 our bytes of eac
7880: 68 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 h overflow page
7890: 61 72 65 20 61 20 62 69 67 2d 65 6e 64 69 61 6e are a big-endian
78a0: 0a 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 .integer which i
78b0: 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 s the page numbe
78c0: 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 70 61 r of the next pa
78d0: 67 65 20 69 6e 20 74 68 65 20 63 68 61 69 6e 2c ge in the chain,
78e0: 20 6f 72 20 7a 65 72 6f 0a 66 6f 72 20 74 68 65 or zero.for the
78f0: 20 66 69 6e 61 6c 20 70 61 67 65 20 69 6e 20 74 final page in t
7900: 68 65 20 63 68 61 69 6e 2e 20 20 54 68 65 20 66 he chain. The f
7910: 69 66 74 68 20 62 79 74 65 20 74 68 72 6f 75 67 ifth byte throug
7920: 68 20 74 68 65 20 6c 61 73 74 20 75 73 61 62 6c h the last usabl
7930: 65 0a 62 79 74 65 20 61 72 65 20 75 73 65 64 20 e.byte are used
7940: 74 6f 20 68 6f 6c 64 20 6f 76 65 72 66 6c 6f 77 to hold overflow
7950: 20 63 6f 6e 74 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c content.</p>..<
7960: 68 33 3e 31 2e 37 20 50 6f 69 6e 74 65 72 20 4d h3>1.7 Pointer M
7970: 61 70 20 6f 72 20 50 74 72 6d 61 70 20 50 61 67 ap or Ptrmap Pag
7980: 65 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 50 6f 69 6e es</h3>..<p>Poin
7990: 74 65 72 20 6d 61 70 20 6f 72 20 70 74 72 6d 61 ter map or ptrma
79a0: 70 20 70 61 67 65 73 20 61 72 65 20 65 78 74 72 p pages are extr
79b0: 61 20 70 61 67 65 73 20 69 6e 73 65 72 74 65 64 a pages inserted
79c0: 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
79d0: 73 65 0a 74 6f 20 6d 61 6b 65 20 74 68 65 20 6f se.to make the o
79e0: 70 65 72 61 74 69 6f 6e 20 6f 66 20 5b 61 75 74 peration of [aut
79f0: 6f 5f 76 61 63 75 75 6d 5d 20 61 6e 64 20 5b 69 o_vacuum] and [i
7a00: 6e 63 72 65 6d 65 6e 74 61 6c 5f 76 61 63 75 75 ncremental_vacuu
7a10: 6d 5d 20 6d 6f 64 65 73 0a 6d 6f 72 65 20 65 66 m] modes.more ef
7a20: 66 69 63 69 65 6e 74 2e 20 20 4f 74 68 65 72 20 ficient. Other
7a30: 70 61 67 65 20 74 79 70 65 73 20 69 6e 20 74 68 page types in th
7a40: 65 20 64 61 74 61 62 61 73 65 20 74 79 70 69 63 e database typic
7a50: 61 6c 6c 79 20 68 61 76 65 20 70 6f 69 6e 74 65 ally have pointe
7a60: 72 73 0a 66 72 6f 6d 20 70 61 72 65 6e 74 20 74 rs.from parent t
7a70: 6f 20 63 68 69 6c 64 2e 20 20 46 6f 72 20 65 78 o child. For ex
7a80: 61 6d 70 6c 65 2c 20 61 20 69 6e 74 65 72 69 6f ample, a interio
7a90: 72 20 62 2d 74 72 65 65 20 70 61 67 65 20 63 6f r b-tree page co
7aa0: 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 72 73 0a ntains pointers.
7ab0: 74 6f 20 69 74 73 20 63 68 69 6c 64 20 62 2d 74 to its child b-t
7ac0: 72 65 65 20 70 61 67 65 73 20 61 6e 64 20 61 6e ree pages and an
7ad0: 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 20 overflow chain
7ae0: 68 61 73 20 61 20 70 6f 69 6e 74 65 72 0a 66 72 has a pointer.fr
7af0: 6f 6d 20 65 61 72 6c 69 65 72 20 74 6f 20 6c 61 om earlier to la
7b00: 74 65 72 20 6c 69 6e 6b 73 20 69 6e 20 74 68 65 ter links in the
7b10: 20 63 68 61 69 6e 2e 20 20 41 20 70 74 72 6d 61 chain. A ptrma
7b20: 70 20 70 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 p page contains
7b30: 6c 69 6e 6b 61 67 65 0a 69 6e 66 6f 72 6d 61 74 linkage.informat
7b40: 69 6f 6e 20 67 6f 69 6e 67 20 69 6e 20 74 68 65 ion going in the
7b50: 20 6f 70 70 6f 73 69 74 65 20 64 69 72 65 63 74 opposite direct
7b60: 69 6f 6e 2c 20 66 72 6f 6d 20 63 68 69 6c 64 20 ion, from child
7b70: 74 6f 20 70 61 72 65 6e 74 2e 3c 2f 70 3e 0a 0a to parent.</p>..
7b80: 3c 70 3e 50 74 72 6d 61 70 20 70 61 67 65 73 20 <p>Ptrmap pages
7b90: 6d 75 73 74 20 65 78 69 73 74 20 69 6e 20 61 6e must exist in an
7ba0: 79 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 y database file
7bb0: 77 68 69 63 68 20 68 61 73 20 61 20 6e 6f 6e 2d which has a non-
7bc0: 7a 65 72 6f 0a 6c 61 72 67 65 73 74 20 72 6f 6f zero.largest roo
7bd0: 74 20 62 2d 74 72 65 65 20 70 61 67 65 20 76 61 t b-tree page va
7be0: 6c 75 65 20 61 74 20 6f 66 66 73 65 74 20 35 32 lue at offset 52
7bf0: 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
7c00: 20 68 65 61 64 65 72 2e 0a 49 66 20 74 68 65 20 header..If the
7c10: 6c 61 72 67 65 73 74 20 72 6f 6f 74 20 62 2d 74 largest root b-t
7c20: 72 65 65 20 70 61 67 65 20 76 61 6c 75 65 20 69 ree page value i
7c30: 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 s zero, then the
7c40: 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 6e database must n
7c50: 6f 74 0a 63 6f 6e 74 61 69 6e 20 70 74 72 6d 61 ot.contain ptrma
7c60: 70 20 70 61 67 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 p pages.</p>..<p
7c70: 3e 49 6e 20 61 20 64 61 74 61 62 61 73 65 20 77 >In a database w
7c80: 69 74 68 20 70 74 72 6d 61 70 20 70 61 67 65 73 ith ptrmap pages
7c90: 2c 20 74 68 65 20 66 69 72 73 74 20 70 74 72 6d , the first ptrm
7ca0: 61 70 20 70 61 67 65 20 69 73 20 70 61 67 65 20 ap page is page
7cb0: 32 2e 0a 41 20 70 74 72 6d 61 70 20 70 61 67 65 2..A ptrmap page
7cc0: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 6e 20 consists of an
7cd0: 61 72 72 61 79 20 6f 66 20 35 2d 62 79 74 65 20 array of 5-byte
7ce0: 65 6e 74 72 69 65 73 2e 20 20 4c 65 74 20 4a 20 entries. Let J
7cf0: 62 65 20 74 68 65 0a 6e 75 6d 62 65 72 20 6f 66 be the.number of
7d00: 20 35 2d 62 79 74 65 20 65 6e 74 72 69 65 73 20 5-byte entries
7d10: 74 68 61 74 20 77 69 6c 6c 20 66 69 74 20 69 6e that will fit in
7d20: 20 74 68 65 20 75 73 61 62 6c 65 20 73 70 61 63 the usable spac
7d30: 65 20 6f 66 20 61 20 70 61 67 65 2e 0a 28 49 6e e of a page..(In
7d40: 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 4a 3d other words, J=
7d50: 55 2f 35 2e 29 20 20 54 68 65 20 66 69 72 73 74 U/5.) The first
7d60: 20 70 74 72 6d 61 70 20 70 61 67 65 20 77 69 6c ptrmap page wil
7d70: 6c 20 63 6f 6e 74 61 69 6e 20 62 61 63 6b 20 70 l contain back p
7d80: 6f 69 6e 74 65 72 0a 69 6e 66 6f 72 6d 61 74 69 ointer.informati
7d90: 6f 6e 20 66 6f 72 20 70 61 67 65 73 20 33 20 74 on for pages 3 t
7da0: 68 72 6f 75 67 68 20 4a 2b 32 2c 20 69 6e 63 6c hrough J+2, incl
7db0: 75 73 69 76 65 2e 20 20 54 68 65 20 6e 65 78 74 usive. The next
7dc0: 20 70 6f 69 6e 74 65 72 20 6d 61 70 0a 70 61 67 pointer map.pag
7dd0: 65 20 77 69 6c 6c 20 62 65 20 6f 6e 20 70 61 67 e will be on pag
7de0: 65 20 4a 2b 33 20 61 6e 64 20 74 68 61 74 20 70 e J+3 and that p
7df0: 74 72 6d 61 70 20 70 61 67 65 20 77 69 6c 6c 20 trmap page will
7e00: 70 72 6f 76 69 64 65 20 62 61 63 6b 20 70 6f 69 provide back poi
7e10: 6e 74 65 72 0a 69 6e 66 6f 72 6d 61 74 69 6f 6e nter.information
7e20: 20 66 6f 72 20 70 61 67 65 73 20 4a 2b 34 20 74 for pages J+4 t
7e30: 68 72 6f 75 67 68 20 32 2a 4a 2b 33 20 69 6e 63 hrough 2*J+3 inc
7e40: 6c 75 73 69 76 65 2e 20 20 41 6e 20 73 6f 20 66 lusive. An so f
7e50: 6f 72 74 68 20 66 6f 72 0a 74 68 65 20 65 6e 74 orth for.the ent
7e60: 69 72 65 20 64 61 74 61 62 61 73 65 20 66 69 6c ire database fil
7e70: 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 61 20 e.</p>..<p>In a
7e80: 64 61 74 61 62 61 73 65 20 74 68 61 74 20 75 73 database that us
7e90: 65 73 20 70 74 72 6d 61 70 20 70 61 67 65 73 2c es ptrmap pages,
7ea0: 20 61 6c 6c 20 70 61 67 65 73 20 61 74 20 6c 6f all pages at lo
7eb0: 63 61 74 69 6f 6e 73 20 69 64 65 6e 74 69 66 69 cations identifi
7ec0: 65 64 0a 62 79 20 74 68 65 20 63 6f 6d 70 75 74 ed.by the comput
7ed0: 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 70 72 65 ation in the pre
7ee0: 76 69 6f 75 73 20 70 61 72 61 67 72 61 70 68 20 vious paragraph
7ef0: 6d 75 73 74 20 62 65 20 70 74 72 6d 61 70 20 70 must be ptrmap p
7f00: 61 67 65 20 61 6e 64 20 6e 6f 0a 6f 74 68 65 72 age and no.other
7f10: 20 70 61 67 65 20 6d 61 79 20 62 65 20 61 20 70 page may be a p
7f20: 74 72 6d 61 70 20 70 61 67 65 2e 20 20 45 78 63 trmap page. Exc
7f30: 65 70 74 2c 20 69 66 20 74 68 65 20 62 79 74 65 ept, if the byte
7f40: 2d 6c 6f 63 6b 20 70 61 67 65 20 68 61 70 70 65 -lock page happe
7f50: 6e 73 20 74 6f 0a 66 61 6c 6c 20 6f 6e 20 74 68 ns to.fall on th
7f60: 65 20 73 61 6d 65 20 70 61 67 65 20 6e 75 6d 62 e same page numb
7f70: 65 72 20 61 73 20 61 20 70 74 72 6d 61 70 20 70 er as a ptrmap p
7f80: 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 70 74 age, then the pt
7f90: 72 6d 61 70 20 69 73 20 6d 6f 76 65 64 0a 74 6f rmap is moved.to
7fa0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 the following p
7fb0: 61 67 65 20 66 6f 72 20 74 68 61 74 20 6f 6e 65 age for that one
7fc0: 20 63 61 73 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45 case.</p>..<p>E
7fd0: 61 63 68 20 35 2d 62 79 74 65 20 65 6e 74 72 79 ach 5-byte entry
7fe0: 20 6f 6e 20 61 20 70 74 72 6d 61 70 20 70 61 67 on a ptrmap pag
7ff0: 65 20 70 72 6f 76 69 64 65 73 20 62 61 63 6b 2d e provides back-
8000: 6c 69 6e 6b 20 69 6e 66 6f 72 6d 61 74 69 6f 6e link information
8010: 20 61 62 6f 75 74 20 0a 6f 6e 65 20 6f 66 20 70 about .one of p
8020: 61 67 65 73 20 74 68 61 74 20 69 6d 6d 65 64 69 ages that immedi
8030: 61 74 65 6c 79 20 66 6f 6c 6c 6f 77 20 74 68 65 ately follow the
8040: 20 70 6f 69 6e 74 65 72 20 6d 61 70 2e 20 20 49 pointer map. I
8050: 66 20 70 61 67 65 20 42 20 69 73 0a 70 74 72 6d f page B is.ptrm
8060: 61 70 20 70 61 67 65 20 74 68 65 6e 20 62 61 63 ap page then bac
8070: 6b 2d 6c 69 6e 6b 20 69 6e 66 6f 72 6d 61 74 69 k-link informati
8080: 6f 6e 20 61 62 6f 75 74 20 70 61 67 65 20 42 2b on about page B+
8090: 31 20 69 73 20 70 72 6f 76 69 64 65 64 20 62 79 1 is provided by
80a0: 0a 74 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 .the first entry
80b0: 20 6f 6e 20 74 68 65 20 70 6f 69 6e 74 65 72 20 on the pointer
80c0: 6d 61 70 2e 20 20 49 6e 66 6f 72 6d 61 74 69 6f map. Informatio
80d0: 6e 20 61 62 6f 75 74 20 70 61 67 65 20 42 2b 32 n about page B+2
80e0: 20 69 73 0a 70 72 6f 76 69 64 65 64 20 62 79 20 is.provided by
80f0: 74 68 65 20 73 65 63 6f 6e 64 20 65 6e 74 72 79 the second entry
8100: 2e 20 20 41 6e 64 20 73 6f 20 66 6f 72 74 68 2e . And so forth.
8110: 3c 2f 70 3e 0a 0a 3c 70 3e 45 61 63 68 20 35 2d </p>..<p>Each 5-
8120: 62 79 74 65 20 70 74 72 6d 61 70 20 65 6e 74 72 byte ptrmap entr
8130: 79 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 6f 6e y consists of on
8140: 65 20 62 79 74 65 20 6f 66 20 22 70 61 67 65 20 e byte of "page
8150: 74 79 70 65 22 20 69 6e 66 6f 72 6d 61 74 69 6f type" informatio
8160: 6e 0a 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 n.followed by a
8170: 34 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 4-byte big-endia
8180: 6e 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 20 20 n page number.
8190: 46 69 76 65 20 70 61 67 65 20 74 79 70 65 73 20 Five page types
81a0: 61 72 65 20 72 65 63 6f 67 6e 69 7a 65 64 3a 0a are recognized:.
81b0: 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 41 </p>..<ol>.<li>A
81c0: 20 62 2d 74 72 65 65 20 72 6f 6f 74 20 70 61 67 b-tree root pag
81d0: 65 2e 20 20 54 68 65 0a 70 61 67 65 20 6e 75 6d e. The.page num
81e0: 62 65 72 20 73 68 6f 75 6c 64 20 62 65 20 7a 65 ber should be ze
81f0: 72 6f 2e 0a 3c 6c 69 3e 41 20 66 72 65 65 6c 69 ro..<li>A freeli
8200: 73 74 20 70 61 67 65 2e 20 20 54 68 65 20 70 61 st page. The pa
8210: 67 65 20 6e 75 6d 62 65 72 20 73 68 6f 75 6c 64 ge number should
8220: 20 62 65 0a 7a 65 72 6f 2e 0a 3c 6c 69 3e 54 68 be.zero..<li>Th
8230: 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 e first page of
8240: 61 0a 63 65 6c 6c 20 70 61 79 6c 6f 61 64 20 6f a.cell payload o
8250: 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 2e 20 20 verflow chain.
8260: 54 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 The page number
8270: 69 73 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 is the b-tree pa
8280: 67 65 20 74 68 61 74 0a 63 6f 6e 74 61 69 6e 73 ge that.contains
8290: 20 74 68 65 20 63 65 6c 6c 20 77 68 6f 73 65 20 the cell whose
82a0: 63 6f 6e 74 65 6e 74 20 68 61 73 20 6f 76 65 72 content has over
82b0: 66 6c 6f 77 65 64 2e 0a 3c 6c 69 3e 41 20 70 61 flowed..<li>A pa
82c0: 67 65 20 69 6e 20 61 6e 20 6f 76 65 72 66 6c 6f ge in an overflo
82d0: 77 20 63 68 61 69 6e 0a 6f 74 68 65 72 20 74 68 w chain.other th
82e0: 61 6e 20 74 68 65 20 66 69 72 73 74 20 70 61 67 an the first pag
82f0: 65 2e 20 20 54 68 65 20 70 61 67 65 20 6e 75 6d e. The page num
8300: 62 65 72 20 69 73 20 74 68 65 20 70 72 69 6f 72 ber is the prior
8310: 20 70 61 67 65 20 6f 66 20 74 68 65 0a 6f 76 65 page of the.ove
8320: 72 66 6c 6f 77 20 63 68 61 69 6e 2e 0a 3c 6c 69 rflow chain..<li
8330: 3e 41 20 6e 6f 6e 2d 72 6f 6f 74 20 62 2d 74 72 >A non-root b-tr
8340: 65 65 20 70 61 67 65 2e 20 20 54 68 65 0a 70 61 ee page. The.pa
8350: 67 65 20 6e 75 6d 62 65 72 20 69 73 20 74 68 65 ge number is the
8360: 20 70 61 72 65 6e 74 20 62 2d 74 72 65 65 20 70 parent b-tree p
8370: 61 67 65 2e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 49 age..</ol>..<p>I
8380: 6e 20 61 6e 79 20 64 61 74 61 62 61 73 65 20 66 n any database f
8390: 69 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e ile that contain
83a0: 73 20 70 74 72 6d 61 70 20 70 61 67 65 73 2c 20 s ptrmap pages,
83b0: 61 6c 6c 20 62 2d 74 72 65 65 20 72 6f 6f 74 20 all b-tree root
83c0: 70 61 67 65 73 20 0a 6d 75 73 74 20 63 6f 6d 65 pages .must come
83d0: 20 62 65 66 6f 72 65 20 61 6e 79 20 6e 6f 6e 2d before any non-
83e0: 72 6f 6f 74 20 62 2d 74 72 65 65 20 70 61 67 65 root b-tree page
83f0: 2c 20 63 65 6c 6c 20 70 61 79 6c 6f 61 64 20 6f , cell payload o
8400: 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 6f 72 verflow page, or
8410: 0a 66 72 65 65 6c 69 73 74 20 70 61 67 65 2e 3c .freelist page.<
8420: 2f 70 3e 0a 0a 3c 68 32 3e 32 2e 30 20 53 63 68 /p>..<h2>2.0 Sch
8430: 65 6d 61 20 4c 61 79 65 72 3c 2f 68 32 3e 0a 0a ema Layer</h2>..
8440: 3c 70 3e 54 68 65 20 66 6f 72 65 67 6f 69 6e 67 <p>The foregoing
8450: 20 74 65 78 74 20 64 65 73 63 72 69 62 65 73 20 text describes
8460: 6c 6f 77 2d 6c 65 76 65 6c 20 61 73 70 65 63 74 low-level aspect
8470: 73 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 s of the SQLite
8480: 66 69 6c 65 0a 66 6f 72 6d 61 74 2e 20 20 54 68 file.format. Th
8490: 65 20 62 2d 74 72 65 65 20 6d 65 63 68 61 6e 69 e b-tree mechani
84a0: 73 6d 20 70 72 6f 76 69 64 65 73 20 70 6f 77 65 sm provides powe
84b0: 72 66 75 6c 20 61 6e 64 20 65 66 66 69 63 69 65 rful and efficie
84c0: 6e 74 20 6d 65 61 6e 73 20 6f 66 0a 61 63 63 65 nt means of.acce
84d0: 73 73 69 6e 67 20 61 20 6c 61 72 67 65 20 64 61 ssing a large da
84e0: 74 61 20 73 65 74 2e 20 20 54 68 69 73 20 73 65 ta set. This se
84f0: 63 74 69 6f 6e 20 77 69 6c 6c 20 64 65 73 63 72 ction will descr
8500: 69 62 65 20 68 6f 77 20 74 68 65 0a 6c 6f 77 2d ibe how the.low-
8510: 6c 65 76 65 6c 20 62 2d 74 72 65 65 20 6c 61 79 level b-tree lay
8520: 65 72 20 69 73 20 75 73 65 64 20 74 6f 20 69 6d er is used to im
8530: 70 6c 65 6d 65 6e 74 20 68 69 67 68 65 72 2d 6c plement higher-l
8540: 65 76 65 6c 20 53 51 4c 0a 63 61 70 61 62 69 6c evel SQL.capabil
8550: 69 74 69 65 73 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c ities.</p>..<tcl
8560: 3e 68 64 5f 66 72 61 67 6d 65 6e 74 20 72 65 63 >hd_fragment rec
8570: 6f 72 64 5f 66 6f 72 6d 61 74 20 7b 72 65 63 6f ord_format {reco
8580: 72 64 20 66 6f 72 6d 61 74 7d 3c 2f 74 63 6c 3e rd format}</tcl>
8590: 0a 3c 68 33 3e 32 2e 31 20 52 65 63 6f 72 64 20 .<h3>2.1 Record
85a0: 46 6f 72 6d 61 74 3c 2f 68 33 3e 0a 0a 3c 70 3e Format</h3>..<p>
85b0: 54 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 The content of a
85c0: 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 6c 65 table b-tree le
85d0: 61 66 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 af page and the
85e0: 6b 65 79 0a 6f 66 20 61 6e 79 20 69 6e 64 65 78 key.of any index
85f0: 20 62 2d 74 72 65 65 20 70 61 67 65 20 77 61 73 b-tree page was
8600: 20 63 68 61 72 61 63 74 65 72 69 7a 65 64 20 61 characterized a
8610: 62 6f 76 65 0a 61 73 20 61 6e 20 61 72 62 69 74 bove.as an arbit
8620: 72 61 72 79 20 73 65 71 75 65 6e 63 65 20 6f 66 rary sequence of
8630: 20 62 79 74 65 73 2e 0a 54 68 65 20 70 72 69 6f bytes..The prio
8640: 72 20 64 69 73 63 75 73 73 69 6f 6e 20 6d 65 6e r discussion men
8650: 74 69 6f 6e 65 64 20 6f 6e 65 20 6b 65 79 20 62 tioned one key b
8660: 65 69 6e 67 20 6c 65 73 73 20 74 68 61 6e 20 61 eing less than a
8670: 6e 6f 74 68 65 72 2c 20 62 75 74 0a 64 69 64 20 nother, but.did
8680: 6e 6f 74 20 64 65 66 69 6e 65 20 77 68 61 74 20 not define what
8690: 22 6c 65 73 73 20 74 68 61 6e 22 20 6d 65 61 6e "less than" mean
86a0: 74 2e 20 20 54 68 65 20 63 75 72 72 65 6e 74 20 t. The current
86b0: 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20 61 64 64 section will add
86c0: 72 65 73 73 0a 74 68 65 73 65 20 64 65 66 69 63 ress.these defic
86d0: 69 65 6e 63 69 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 iencies.</p>..<p
86e0: 3e 50 61 79 6c 6f 61 64 2c 20 62 65 20 69 74 20 >Payload, be it
86f0: 74 61 62 6c 65 20 63 6f 6e 74 65 6e 74 20 6f 72 table content or
8700: 20 69 6e 64 65 78 20 6b 65 79 73 2c 20 69 73 20 index keys, is
8710: 61 6c 77 61 79 73 20 69 6e 20 74 68 65 20 22 72 always in the "r
8720: 65 63 6f 72 64 0a 66 6f 72 6d 61 74 22 2e 20 20 ecord.format".
8730: 54 68 65 20 72 65 63 6f 72 64 20 66 6f 72 6d 61 The record forma
8740: 74 20 64 65 66 69 6e 65 73 20 61 20 73 65 71 75 t defines a sequ
8750: 65 6e 63 65 20 6f 66 20 76 61 6c 75 65 73 20 63 ence of values c
8760: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 0a orresponding to.
8770: 74 6f 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 61 20 to columns in a
8780: 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 table or index.
8790: 20 54 68 65 20 72 65 63 6f 72 64 20 66 6f 72 6d The record form
87a0: 61 74 20 73 70 65 63 69 66 69 65 73 20 74 68 65 at specifies the
87b0: 20 6e 75 6d 62 65 72 0a 6f 66 20 63 6f 6c 75 6d number.of colum
87c0: 6e 73 2c 20 74 68 65 20 64 61 74 61 74 79 70 65 ns, the datatype
87d0: 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2c of each column,
87e0: 20 61 6e 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 and the content
87f0: 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2e of each column.
8800: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 72 65 63 </p>..<p>The rec
8810: 6f 72 64 20 66 6f 72 6d 61 74 20 6d 61 6b 65 73 ord format makes
8820: 20 65 78 74 65 6e 73 69 76 65 20 75 73 65 20 6f extensive use o
8830: 66 20 74 68 65 20 0a 5b 76 61 72 69 61 62 6c 65 f the .[variable
8840: 2d 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 5d -length integer]
8850: 20 6f 72 20 5b 76 61 72 69 6e 74 5d 0a 72 65 70 or [varint].rep
8860: 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 36 resentation of 6
8870: 34 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 4-bit signed int
8880: 65 67 65 72 73 20 64 65 66 69 6e 65 64 20 61 62 egers defined ab
8890: 6f 76 65 2e 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 68 ove.</p>..<tcl>h
88a0: 64 5f 66 72 61 67 6d 65 6e 74 20 73 65 72 69 61 d_fragment seria
88b0: 6c 74 79 70 65 20 7b 73 65 72 69 61 6c 20 74 79 ltype {serial ty
88c0: 70 65 7d 20 7b 73 65 72 69 61 6c 20 74 79 70 65 pe} {serial type
88d0: 73 7d 3c 2f 74 63 6c 3e 0a 3c 70 3e 41 20 72 65 s}</tcl>.<p>A re
88e0: 63 6f 72 64 20 63 6f 6e 74 61 69 6e 73 20 61 20 cord contains a
88f0: 68 65 61 64 65 72 20 61 6e 64 20 61 20 62 6f 64 header and a bod
8900: 79 2c 20 69 6e 20 74 68 61 74 20 6f 72 64 65 72 y, in that order
8910: 2e 20 20 0a 54 68 65 20 68 65 61 64 65 72 20 62 . .The header b
8920: 65 67 69 6e 73 20 77 69 74 68 20 61 20 73 69 6e egins with a sin
8930: 67 6c 65 20 76 61 72 69 6e 74 20 77 68 69 63 68 gle varint which
8940: 20 64 65 74 65 72 6d 69 6e 65 73 20 74 68 65 20 determines the
8950: 74 6f 74 61 6c 20 6e 75 6d 62 65 72 0a 6f 66 20 total number.of
8960: 62 79 74 65 73 20 69 6e 20 74 68 65 20 68 65 61 bytes in the hea
8970: 64 65 72 2e 20 20 54 68 65 20 76 61 72 69 6e 74 der. The varint
8980: 20 76 61 6c 75 65 20 69 73 20 74 68 65 20 73 69 value is the si
8990: 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 ze of the header
89a0: 20 69 6e 0a 62 79 74 65 20 69 6e 63 6c 75 64 69 in.byte includi
89b0: 6e 67 20 74 68 65 20 73 69 7a 65 20 76 61 72 69 ng the size vari
89c0: 6e 74 20 69 74 73 65 6c 66 2e 20 20 46 6f 6c 6c nt itself. Foll
89d0: 6f 77 69 6e 67 20 74 68 65 20 73 69 7a 65 20 76 owing the size v
89e0: 61 72 69 6e 74 20 61 72 65 0a 6f 6e 65 20 6f 72 arint are.one or
89f0: 20 6d 6f 72 65 20 61 64 64 69 74 69 6f 6e 61 6c more additional
8a00: 20 76 61 72 69 6e 74 73 2c 20 6f 6e 65 20 70 65 varints, one pe
8a10: 72 20 63 6f 6c 75 6d 6e 2e 20 20 54 68 65 73 65 r column. These
8a20: 20 61 64 64 69 74 69 6f 6e 61 6c 20 76 61 72 69 additional vari
8a30: 6e 74 73 0a 61 72 65 20 63 61 6c 6c 65 64 20 22 nts.are called "
8a40: 73 65 72 69 61 6c 20 74 79 70 65 22 20 6e 75 6d serial type" num
8a50: 62 65 72 73 20 61 6e 64 0a 64 65 74 65 72 6d 69 bers and.determi
8a60: 6e 65 20 74 68 65 20 64 61 74 61 74 79 70 65 20 ne the datatype
8a70: 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2c 20 of each column,
8a80: 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 according to the
8a90: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6b 65 79 3a 3c following key:<
8aa0: 2f 70 3e 0a 0a 3c 63 65 6e 74 65 72 3e 0a 3c 69 /p>..<center>.<i
8ab0: 3e 53 65 72 69 61 6c 20 54 79 70 65 20 43 6f 64 >Serial Type Cod
8ac0: 65 73 20 4f 66 20 54 68 65 20 52 65 63 6f 72 64 es Of The Record
8ad0: 20 46 6f 72 6d 61 74 3c 2f 69 3e 3c 62 72 3e 0a Format</i><br>.
8ae0: 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 38 30 <table width="80
8af0: 25 22 20 62 6f 72 64 65 72 3d 31 3e 0a 3c 74 72 %" border=1>.<tr
8b00: 3e 3c 74 68 3e 53 65 72 69 61 6c 20 54 79 70 65 ><th>Serial Type
8b10: 3c 74 68 3e 43 6f 6e 74 65 6e 74 20 53 69 7a 65 <th>Content Size
8b20: 3c 74 68 3e 4d 65 61 6e 69 6e 67 0a 3c 74 72 3e <th>Meaning.<tr>
8b30: 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 <td valign=top a
8b40: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 30 3c 74 64 lign=center>0<td
8b50: 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 valign=top alig
8b60: 6e 3d 63 65 6e 74 65 72 3e 30 3c 74 64 20 61 6c n=center>0<td al
8b70: 69 67 6e 3d 6c 65 66 74 3e 0a 4e 55 4c 4c 0a 3c ign=left>.NULL.<
8b80: 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f tr><td valign=to
8b90: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 p align=center>1
8ba0: 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 <td valign=top a
8bb0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 3c 74 64 lign=center>1<td
8bc0: 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 38 2d 62 align=left>.8-b
8bd0: 69 74 20 74 77 6f 73 2d 63 6f 6d 70 6c 65 6d 65 it twos-compleme
8be0: 6e 74 20 69 6e 74 65 67 65 72 0a 3c 74 72 3e 3c nt integer.<tr><
8bf0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
8c00: 69 67 6e 3d 63 65 6e 74 65 72 3e 32 3c 74 64 20 ign=center>2<td
8c10: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
8c20: 3d 63 65 6e 74 65 72 3e 32 3c 74 64 20 61 6c 69 =center>2<td ali
8c30: 67 6e 3d 6c 65 66 74 3e 0a 42 69 67 2d 65 6e 64 gn=left>.Big-end
8c40: 69 61 6e 20 31 36 2d 62 69 74 20 74 77 6f 73 2d ian 16-bit twos-
8c50: 63 6f 6d 70 6c 65 6d 65 6e 74 20 69 6e 74 65 67 complement integ
8c60: 65 72 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 er.<tr><td valig
8c70: 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 n=top align=cent
8c80: 65 72 3e 33 3c 74 64 20 76 61 6c 69 67 6e 3d 74 er>3<td valign=t
8c90: 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e op align=center>
8ca0: 33 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 3<td align=left>
8cb0: 0a 42 69 67 2d 65 6e 64 69 61 6e 20 32 34 2d 62 .Big-endian 24-b
8cc0: 69 74 20 74 77 6f 73 2d 63 6f 6d 70 6c 65 6d 65 it twos-compleme
8cd0: 6e 74 20 69 6e 74 65 67 65 72 0a 3c 74 72 3e 3c nt integer.<tr><
8ce0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
8cf0: 69 67 6e 3d 63 65 6e 74 65 72 3e 34 3c 74 64 20 ign=center>4<td
8d00: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
8d10: 3d 63 65 6e 74 65 72 3e 34 3c 74 64 20 61 6c 69 =center>4<td ali
8d20: 67 6e 3d 6c 65 66 74 3e 0a 42 69 67 2d 65 6e 64 gn=left>.Big-end
8d30: 69 61 6e 20 33 32 2d 62 69 74 20 74 77 6f 73 2d ian 32-bit twos-
8d40: 63 6f 6d 70 6c 65 6d 65 6e 74 20 69 6e 74 65 67 complement integ
8d50: 65 72 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 er.<tr><td valig
8d60: 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 n=top align=cent
8d70: 65 72 3e 35 3c 74 64 20 76 61 6c 69 67 6e 3d 74 er>5<td valign=t
8d80: 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e op align=center>
8d90: 36 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 6<td align=left>
8da0: 0a 42 69 67 2d 65 6e 64 69 61 6e 20 34 38 2d 62 .Big-endian 48-b
8db0: 69 74 20 74 77 6f 73 2d 63 6f 6d 70 6c 65 6d 65 it twos-compleme
8dc0: 6e 74 20 69 6e 74 65 67 65 72 0a 3c 74 72 3e 3c nt integer.<tr><
8dd0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
8de0: 69 67 6e 3d 63 65 6e 74 65 72 3e 36 3c 74 64 20 ign=center>6<td
8df0: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
8e00: 3d 63 65 6e 74 65 72 3e 38 3c 74 64 20 61 6c 69 =center>8<td ali
8e10: 67 6e 3d 6c 65 66 74 3e 0a 42 69 67 2d 65 6e 64 gn=left>.Big-end
8e20: 69 61 6e 20 36 34 2d 62 69 74 20 74 77 6f 73 2d ian 64-bit twos-
8e30: 63 6f 6d 70 6c 65 6d 65 6e 74 20 69 6e 74 65 67 complement integ
8e40: 65 72 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 er.<tr><td valig
8e50: 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 n=top align=cent
8e60: 65 72 3e 37 3c 74 64 20 76 61 6c 69 67 6e 3d 74 er>7<td valign=t
8e70: 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e op align=center>
8e80: 38 3c 74 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 8<td align=left>
8e90: 0a 42 69 67 2d 65 6e 64 69 61 6e 20 49 45 45 45 .Big-endian IEEE
8ea0: 20 37 35 34 2d 32 30 30 38 20 36 34 2d 62 69 74 754-2008 64-bit
8eb0: 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 floating point
8ec0: 6e 75 6d 62 65 72 0a 3c 74 72 3e 3c 74 64 20 76 number.<tr><td v
8ed0: 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d align=top align=
8ee0: 63 65 6e 74 65 72 3e 38 3c 74 64 20 76 61 6c 69 center>8<td vali
8ef0: 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e gn=top align=cen
8f00: 74 65 72 3e 30 3c 74 64 20 61 6c 69 67 6e 3d 6c ter>0<td align=l
8f10: 65 66 74 3e 0a 49 6e 74 65 67 65 72 20 63 6f 6e eft>.Integer con
8f20: 73 74 61 6e 74 20 30 2e 20 20 4f 6e 6c 79 20 61 stant 0. Only a
8f30: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 73 63 68 vailable for sch
8f40: 65 6d 61 20 66 6f 72 6d 61 74 20 34 20 61 6e 64 ema format 4 and
8f50: 20 68 69 67 68 65 72 2e 0a 3c 74 72 3e 3c 74 64 higher..<tr><td
8f60: 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 valign=top alig
8f70: 6e 3d 63 65 6e 74 65 72 3e 39 3c 74 64 20 76 61 n=center>9<td va
8f80: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
8f90: 65 6e 74 65 72 3e 30 3c 74 64 20 61 6c 69 67 6e enter>0<td align
8fa0: 3d 6c 65 66 74 3e 0a 49 6e 74 65 67 65 72 20 63 =left>.Integer c
8fb0: 6f 6e 73 74 61 6e 74 20 31 2e 20 20 4f 6e 6c 79 onstant 1. Only
8fc0: 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 73 available for s
8fd0: 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 34 20 61 chema format 4 a
8fe0: 6e 64 20 68 69 67 68 65 72 2e 0a 3c 74 72 3e 3c nd higher..<tr><
8ff0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
9000: 69 67 6e 3d 63 65 6e 74 65 72 3e 31 30 2c 31 31 ign=center>10,11
9010: 0a 20 20 20 20 3c 74 64 20 76 61 6c 69 67 6e 3d . <td valign=
9020: 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 top align=center
9030: 3e 26 6e 62 73 70 3b 3c 74 64 20 61 6c 69 67 6e > <td align
9040: 3d 6c 65 66 74 3e 0a 3c 69 3e 4e 6f 74 20 75 73 =left>.<i>Not us
9050: 65 64 2e 20 20 52 65 73 65 72 76 65 64 20 66 6f ed. Reserved fo
9060: 72 20 65 78 70 61 6e 73 69 6f 6e 2e 3c 2f 69 3e r expansion.</i>
9070: 0a 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d .<tr><td valign=
9080: 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 top align=center
9090: 3e 4e 26 23 78 32 32 36 35 3b 31 32 20 61 6e 64 >N≥12 and
90a0: 20 65 76 65 6e 0a 20 20 20 20 3c 74 64 20 76 61 even. <td va
90b0: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
90c0: 65 6e 74 65 72 3e 28 4e 2d 31 32 29 2f 32 3c 74 enter>(N-12)/2<t
90d0: 64 20 61 6c 69 67 6e 3d 6c 65 66 74 3e 0a 41 20 d align=left>.A
90e0: 73 74 72 69 6e 67 20 69 6e 20 74 68 65 20 64 61 string in the da
90f0: 74 61 62 61 73 65 20 65 6e 63 6f 64 69 6e 67 20 tabase encoding
9100: 61 6e 64 20 28 4e 2d 31 32 29 2f 32 20 62 79 74 and (N-12)/2 byt
9110: 65 73 20 69 6e 20 6c 65 6e 67 74 68 2e 0a 54 68 es in length..Th
9120: 65 20 6e 75 6c 20 74 65 72 6d 69 6e 61 74 6f 72 e nul terminator
9130: 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 3c 74 72 is omitted..<tr
9140: 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 ><td valign=top
9150: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 4e 26 23 align=center>N&#
9160: 78 32 32 36 35 3b 31 33 20 61 6e 64 20 6f 64 64 x2265;13 and odd
9170: 0a 20 20 20 20 3c 74 64 20 76 61 6c 69 67 6e 3d . <td valign=
9180: 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 top align=center
9190: 3e 28 4e 2d 31 33 29 2f 32 3c 74 64 20 61 6c 69 >(N-13)/2<td ali
91a0: 67 6e 3d 6c 65 66 74 3e 0a 41 20 42 4c 4f 42 20 gn=left>.A BLOB
91b0: 74 68 61 74 20 69 73 20 28 4e 2d 31 33 29 2f 32 that is (N-13)/2
91c0: 20 62 79 74 65 73 20 69 6e 20 6c 65 6e 67 74 68 bytes in length
91d0: 0a 3c 2f 74 61 62 6c 65 3e 3c 2f 63 65 6e 74 65 .</table></cente
91e0: 72 3e 0a 0a 3c 70 3e 4e 6f 74 65 20 74 68 61 74 r>..<p>Note that
91f0: 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 65 20 because of the
9200: 77 61 79 20 76 61 72 69 6e 74 73 20 61 72 65 20 way varints are
9210: 64 65 66 69 6e 65 64 2c 20 74 68 65 20 68 65 61 defined, the hea
9220: 64 65 72 20 73 69 7a 65 20 76 61 72 69 6e 74 0a der size varint.
9230: 61 6e 64 20 73 65 72 69 61 6c 20 74 79 70 65 20 and serial type
9240: 76 61 72 69 6e 74 73 20 77 69 6c 6c 20 75 73 75 varints will usu
9250: 61 6c 6c 79 20 63 6f 6e 73 69 73 74 20 6f 66 20 ally consist of
9260: 61 20 73 69 6e 67 6c 65 20 62 79 74 65 2e 20 20 a single byte.
9270: 54 68 65 0a 73 65 72 69 61 6c 20 74 79 70 65 20 The.serial type
9280: 76 61 72 69 6e 74 73 20 66 6f 72 20 6c 61 72 67 varints for larg
9290: 65 20 73 74 72 69 6e 67 73 20 61 6e 64 20 42 4c e strings and BL
92a0: 4f 42 73 20 6d 69 67 68 74 20 65 78 74 65 6e 64 OBs might extend
92b0: 20 74 6f 20 74 77 6f 20 6f 72 20 74 68 72 65 65 to two or three
92c0: 0a 62 79 74 65 20 76 61 72 69 6e 74 73 2c 20 62 .byte varints, b
92d0: 75 74 20 74 68 61 74 20 69 73 20 74 68 65 20 65 ut that is the e
92e0: 78 63 65 70 74 69 6f 6e 20 72 61 74 68 65 72 20 xception rather
92f0: 74 68 61 6e 20 74 68 65 20 72 75 6c 65 2e 20 0a than the rule. .
9300: 54 68 65 20 76 61 72 69 6e 74 20 66 6f 72 6d 61 The varint forma
9310: 74 20 69 73 20 76 65 72 79 20 65 66 66 69 63 69 t is very effici
9320: 65 6e 74 20 61 74 20 63 6f 64 69 6e 67 20 74 68 ent at coding th
9330: 65 20 72 65 63 6f 72 64 20 68 65 61 64 65 72 2e e record header.
9340: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 76 61 6c </p>..<p>The val
9350: 75 65 73 20 66 6f 72 20 65 61 63 68 20 63 6f 6c ues for each col
9360: 75 6d 6e 20 69 6e 20 74 68 65 20 72 65 63 6f 72 umn in the recor
9370: 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 66 6f d immediately fo
9380: 6c 6c 6f 77 20 74 68 65 20 68 65 61 64 65 72 2e llow the header.
9390: 0a 4e 6f 74 65 20 74 68 61 74 20 66 6f 72 20 73 .Note that for s
93a0: 65 72 69 61 6c 20 74 79 70 65 73 20 30 2c 20 38 erial types 0, 8
93b0: 2c 20 39 2c 20 31 32 2c 20 61 6e 64 20 31 33 2c , 9, 12, and 13,
93c0: 20 74 68 65 20 76 61 6c 75 65 20 69 73 20 7a 65 the value is ze
93d0: 72 6f 20 62 79 74 65 73 20 69 6e 0a 6c 65 6e 67 ro bytes in.leng
93e0: 74 68 2e 20 20 49 66 20 61 6c 6c 20 63 6f 6c 75 th. If all colu
93f0: 6d 6e 73 20 61 72 65 20 6f 66 20 74 68 65 73 65 mns are of these
9400: 20 74 79 70 65 73 20 74 68 65 6e 20 74 68 65 20 types then the
9410: 62 6f 64 79 20 73 65 63 74 69 6f 6e 20 6f 66 20 body section of
9420: 74 68 65 0a 72 65 63 6f 72 64 20 69 73 20 65 6d the.record is em
9430: 70 74 79 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e pty.</p>..<h3>2.
9440: 32 20 52 65 63 6f 72 64 20 53 6f 72 74 20 4f 72 2 Record Sort Or
9450: 64 65 72 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 der</h3>..<p>The
9460: 20 6f 72 64 65 72 20 6f 66 20 6b 65 79 73 20 69 order of keys i
9470: 6e 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 n an index b-tre
9480: 65 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 e is determined
9490: 62 79 20 74 68 65 20 73 6f 72 74 20 6f 72 64 65 by the sort orde
94a0: 72 20 6f 66 0a 74 68 65 20 72 65 63 6f 72 64 73 r of.the records
94b0: 20 74 68 61 74 20 74 68 65 20 6b 65 79 73 20 72 that the keys r
94c0: 65 70 72 65 73 65 6e 74 2e 20 20 52 65 63 6f 72 epresent. Recor
94d0: 64 20 63 6f 6d 70 61 72 69 73 6f 6e 20 70 72 6f d comparison pro
94e0: 63 65 65 64 73 20 63 6f 6c 75 6d 6e 0a 62 79 20 ceeds column.by
94f0: 63 6f 6c 75 6d 6e 2e 20 20 43 6f 6c 75 6d 6e 73 column. Columns
9500: 20 6f 66 20 61 20 72 65 63 6f 72 64 20 61 72 65 of a record are
9510: 20 65 78 61 6d 69 6e 65 64 20 66 72 6f 6d 20 6c examined from l
9520: 65 66 74 20 74 6f 20 72 69 67 68 74 2e 20 20 54 eft to right. T
9530: 68 65 0a 66 69 72 73 74 20 70 61 69 72 20 6f 66 he.first pair of
9540: 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 61 72 columns that ar
9550: 65 20 6e 6f 74 20 65 71 75 61 6c 20 64 65 74 65 e not equal dete
9560: 72 6d 69 6e 65 73 20 74 68 65 20 72 65 6c 61 74 rmines the relat
9570: 69 76 65 20 6f 72 64 65 72 0a 6f 66 20 74 68 65 ive order.of the
9580: 20 74 77 6f 20 72 65 63 6f 72 64 73 2e 20 20 54 two records. T
9590: 68 65 20 73 6f 72 74 20 6f 72 64 65 72 20 6f 66 he sort order of
95a0: 20 69 6e 64 69 76 69 64 75 61 6c 20 63 6f 6c 75 individual colu
95b0: 6d 6e 73 20 69 73 20 61 73 0a 66 6f 6c 6c 6f 77 mns is as.follow
95c0: 73 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 s:</p>..<ol>.<li
95d0: 3e 4e 55 4c 4c 20 76 61 6c 75 65 73 20 28 73 65 >NULL values (se
95e0: 72 69 61 6c 20 74 79 70 65 20 30 29 20 73 6f 72 rial type 0) sor
95f0: 74 20 66 69 72 73 74 0a 3c 6c 69 3e 4e 75 6d 65 t first.<li>Nume
9600: 72 69 63 20 76 61 6c 75 65 73 20 28 73 65 72 69 ric values (seri
9610: 61 6c 20 74 79 70 65 73 20 31 20 74 68 72 6f 75 al types 1 throu
9620: 67 68 20 39 29 20 73 6f 72 74 20 6e 65 78 74 20 gh 9) sort next
9630: 61 6e 64 20 69 6e 20 6e 75 6d 65 72 69 63 20 6f and in numeric o
9640: 72 64 65 72 0a 3c 6c 69 3e 54 65 78 74 20 76 61 rder.<li>Text va
9650: 6c 75 65 73 20 28 65 76 65 6e 20 73 65 72 69 61 lues (even seria
9660: 6c 20 74 79 70 65 73 20 31 32 20 61 6e 64 20 6c l types 12 and l
9670: 61 72 67 65 72 29 20 73 6f 72 74 20 6e 65 78 74 arger) sort next
9680: 20 69 6e 20 74 68 65 20 6f 72 64 65 72 0a 20 20 in the order.
9690: 20 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 determined by
96a0: 74 68 65 20 63 6f 6c 75 6d 6e 73 20 63 6f 6c 6c the columns coll
96b0: 61 74 69 6e 67 20 66 75 6e 63 74 69 6f 6e 0a 3c ating function.<
96c0: 6c 69 3e 42 4c 4f 42 20 76 61 6c 75 65 73 20 28 li>BLOB values (
96d0: 6f 64 64 20 73 65 72 69 61 6c 20 74 79 70 65 73 odd serial types
96e0: 20 31 33 20 61 6e 64 20 6c 61 72 67 65 72 29 20 13 and larger)
96f0: 73 6f 72 74 20 6c 61 73 74 20 69 6e 20 6f 72 64 sort last in ord
9700: 65 72 20 0a 20 20 20 20 64 65 74 65 72 6d 69 6e er . determin
9710: 65 64 20 62 79 20 6d 65 6d 63 6d 70 28 29 2e 0a ed by memcmp()..
9720: 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 41 20 63 6f 6c 6c </ol>..<p>A coll
9730: 61 74 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 ating function f
9740: 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 69 or each column i
9750: 73 20 6e 65 63 65 73 73 61 72 79 20 69 6e 20 6f s necessary in o
9760: 72 64 65 72 20 74 6f 20 63 6f 6d 70 75 74 65 0a rder to compute.
9770: 74 68 65 20 6f 72 64 65 72 20 6f 66 20 74 65 78 the order of tex
9780: 74 20 66 69 65 6c 64 73 2e 20 20 53 51 4c 69 74 t fields. SQLit
9790: 65 20 64 65 66 69 6e 65 73 20 74 68 72 65 65 20 e defines three
97a0: 62 75 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 built-in collati
97b0: 6e 67 20 66 75 6e 63 74 69 6f 6e 73 3a 0a 3c 2f ng functions:.</
97c0: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e p>..<blockquote>
97d0: 3c 74 61 62 6c 65 20 62 6f 72 64 65 72 3d 30 20 <table border=0
97e0: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 31 30 3e 0a cellspacing=10>.
97f0: 3c 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 <tr><td valign=t
9800: 6f 70 3e 42 49 4e 41 52 59 0a 20 20 20 20 3c 74 op>BINARY. <t
9810: 64 3e 53 74 72 69 6e 67 73 20 61 72 65 20 63 6f d>Strings are co
9820: 6d 70 61 72 69 65 64 20 62 79 74 65 20 62 79 20 mparied byte by
9830: 62 79 74 65 20 75 73 69 6e 67 20 74 68 65 20 6d byte using the m
9840: 65 6d 63 6d 70 28 29 20 66 75 6e 63 74 69 6f 6e emcmp() function
9850: 0a 20 20 20 20 20 20 20 20 66 72 6f 6d 20 74 68 . from th
9860: 65 20 73 74 61 6e 64 61 72 64 20 43 20 6c 69 62 e standard C lib
9870: 72 61 72 79 2e 0a 3c 74 72 3e 3c 74 64 20 76 61 rary..<tr><td va
9880: 6c 69 67 6e 3d 74 6f 70 3e 4e 4f 43 41 53 45 0a lign=top>NOCASE.
9890: 20 20 20 20 3c 74 64 3e 4c 69 6b 65 20 42 49 4e <td>Like BIN
98a0: 41 52 59 20 65 78 63 65 70 74 20 74 68 61 74 20 ARY except that
98b0: 75 70 70 65 72 63 61 73 65 20 41 53 43 49 49 20 uppercase ASCII
98c0: 63 68 61 72 61 63 74 65 72 73 20 28 27 41 27 20 characters ('A'
98d0: 74 68 72 6f 75 67 68 20 27 5a 27 29 0a 20 20 20 through 'Z').
98e0: 20 20 20 20 20 61 72 65 20 66 6f 6c 64 65 64 20 are folded
98f0: 69 6e 74 6f 20 74 68 65 69 72 20 6c 6f 77 65 72 into their lower
9900: 63 61 73 65 20 65 71 75 69 76 61 6c 65 6e 74 73 case equivalents
9910: 20 70 72 69 6f 72 20 74 6f 20 72 75 6e 6e 69 6e prior to runnin
9920: 67 20 74 68 65 0a 20 20 20 20 20 20 20 20 63 6f g the. co
9930: 6d 70 61 72 69 73 6f 6e 2e 20 20 4e 6f 74 65 20 mparison. Note
9940: 74 68 61 74 20 6f 6e 6c 79 20 41 53 43 49 49 20 that only ASCII
9950: 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 63 characters are c
9960: 61 73 65 2d 66 6f 6c 64 65 64 2e 20 20 4e 4f 43 ase-folded. NOC
9970: 41 53 45 0a 20 20 20 20 20 20 20 20 64 6f 65 73 ASE. does
9980: 20 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 20 61 not implement a
9990: 20 67 65 6e 65 72 61 6c 20 70 75 72 70 6f 73 65 general purpose
99a0: 20 75 6e 69 63 6f 64 65 20 63 61 73 65 6c 65 73 unicode caseles
99b0: 73 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 0a 3c 74 s comparison..<t
99c0: 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 r><td valign=top
99d0: 3e 52 54 52 49 4d 0a 20 20 20 20 3c 74 64 3e 4c >RTRIM. <td>L
99e0: 69 6b 65 20 42 49 4e 41 52 59 20 65 78 63 65 70 ike BINARY excep
99f0: 74 20 74 68 61 74 20 73 70 61 63 65 73 20 61 74 t that spaces at
9a00: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
9a10: 73 74 72 69 6e 67 20 61 72 65 20 65 6c 69 64 65 string are elide
9a20: 64 0a 20 20 20 20 20 20 20 20 70 72 69 6f 72 20 d. prior
9a30: 74 6f 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 0a 3c to comparison..<
9a40: 2f 74 61 62 6c 65 3e 3c 2f 62 6c 6f 63 6b 71 75 /table></blockqu
9a50: 6f 74 65 3e 0a 0a 3c 70 3e 41 64 64 69 74 69 6f ote>..<p>Additio
9a60: 6e 61 6c 20 61 70 70 6c 69 63 61 74 69 6f 6e 2d nal application-
9a70: 73 70 65 63 69 66 69 63 20 63 6f 6c 6c 61 74 69 specific collati
9a80: 6e 67 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e ng functions can
9a90: 20 62 65 20 61 64 64 65 64 20 74 6f 0a 53 51 4c be added to.SQL
9aa0: 69 74 65 20 75 73 69 6e 67 20 74 68 65 20 5b 73 ite using the [s
9ab0: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
9ac0: 6c 6c 61 74 69 6f 6e 28 29 5d 20 69 6e 74 65 72 llation()] inter
9ad0: 66 61 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 face.</p>..<p>Th
9ae0: 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 e default collat
9af0: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 ing function for
9b00: 20 61 6c 6c 20 73 74 72 69 6e 67 73 20 69 73 20 all strings is
9b10: 42 49 4e 41 52 59 2e 0a 41 6c 74 65 72 6e 61 74 BINARY..Alternat
9b20: 69 76 65 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 ive collating fu
9b30: 6e 63 74 69 6f 6e 73 20 66 6f 72 20 74 61 62 6c nctions for tabl
9b40: 65 20 63 6f 6c 75 6d 6e 73 20 63 61 6e 20 62 65 e columns can be
9b50: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 specified in th
9b60: 65 0a 5b 43 52 45 41 54 45 20 54 41 42 4c 45 5d e.[CREATE TABLE]
9b70: 20 73 74 61 74 65 6d 65 6e 74 20 75 73 69 6e 67 statement using
9b80: 20 74 68 65 20 43 4f 4c 4c 41 54 45 20 63 6c 61 the COLLATE cla
9b90: 75 73 65 20 6f 6e 20 74 68 65 20 63 6f 6c 75 6d use on the colum
9ba0: 6e 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 57 68 n definition..Wh
9bb0: 65 6e 20 61 20 63 6f 6c 75 6d 6e 20 69 73 20 69 en a column is i
9bc0: 6e 64 65 78 65 64 2c 20 74 68 65 20 73 61 6d 65 ndexed, the same
9bd0: 20 63 6f 6c 6c 61 74 69 6e 67 20 66 75 6e 63 74 collating funct
9be0: 69 6f 6e 20 73 70 65 63 69 66 69 65 64 20 69 6e ion specified in
9bf0: 20 74 68 65 0a 5b 43 52 45 41 54 45 20 54 41 42 the.[CREATE TAB
9c00: 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74 20 69 73 LE] statement is
9c10: 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 63 6f used for the co
9c20: 6c 75 6d 6e 20 69 6e 20 74 68 65 20 69 6e 64 65 lumn in the inde
9c30: 78 2c 20 62 79 20 64 65 66 61 75 6c 74 2c 0a 74 x, by default,.t
9c40: 68 6f 75 67 68 20 74 68 69 73 20 63 61 6e 20 62 hough this can b
9c50: 65 20 6f 76 65 72 72 69 64 64 65 6e 20 75 73 69 e overridden usi
9c60: 6e 67 20 61 20 43 4f 4c 4c 41 54 45 20 63 6c 61 ng a COLLATE cla
9c70: 75 73 65 20 69 6e 20 74 68 65 20 0a 5b 43 52 45 use in the .[CRE
9c80: 41 54 45 20 49 4e 44 45 58 5d 20 73 74 61 74 65 ATE INDEX] state
9c90: 6d 65 6e 74 2e 0a 0a 3c 68 33 3e 32 2e 33 20 52 ment...<h3>2.3 R
9ca0: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 4f 66 epresentation Of
9cb0: 20 53 51 4c 20 54 61 62 6c 65 73 3c 2f 68 33 3e SQL Tables</h3>
9cc0: 0a 0a 3c 70 3e 45 61 63 68 20 6f 72 64 69 6e 61 ..<p>Each ordina
9cd0: 72 79 20 53 51 4c 20 74 61 62 6c 65 20 69 6e 20 ry SQL table in
9ce0: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 the database sch
9cf0: 65 6d 61 20 69 73 20 72 65 70 72 65 73 65 6e 74 ema is represent
9d00: 65 64 20 6f 6e 20 64 69 73 6b 0a 62 79 20 61 20 ed on disk.by a
9d10: 74 61 62 6c 65 20 62 2d 74 72 65 65 2e 20 20 45 table b-tree. E
9d20: 61 63 68 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ach entry in the
9d30: 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 63 6f table b-tree co
9d40: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 61 20 72 rresponds to a r
9d50: 6f 77 0a 6f 66 20 74 68 65 20 53 51 4c 20 74 61 ow.of the SQL ta
9d60: 62 6c 65 2e 20 20 54 68 65 20 5b 72 6f 77 69 64 ble. The [rowid
9d70: 5d 20 6f 66 20 74 68 65 20 53 51 4c 20 74 61 62 ] of the SQL tab
9d80: 6c 65 20 69 73 20 74 68 65 20 36 34 2d 62 69 74 le is the 64-bit
9d90: 20 73 69 67 6e 65 64 0a 69 6e 74 65 67 65 72 20 signed.integer
9da0: 6b 65 79 20 66 6f 72 20 65 61 63 68 20 65 6e 74 key for each ent
9db0: 72 79 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 ry in the table
9dc0: 62 2d 74 72 65 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e b-tree.</p>..<p>
9dd0: 54 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 65 The content of e
9de0: 61 63 68 20 53 51 4c 20 74 61 62 6c 65 20 72 6f ach SQL table ro
9df0: 77 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 w is stored in t
9e00: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
9e10: 20 62 79 0a 66 69 72 73 74 20 63 6f 6d 62 69 6e by.first combin
9e20: 69 6e 67 20 74 68 65 20 76 61 6c 75 65 73 20 69 ing the values i
9e30: 6e 20 74 68 65 20 76 61 72 69 6f 75 73 20 63 6f n the various co
9e40: 6c 75 6d 6e 73 20 69 6e 74 6f 20 61 20 62 79 74 lumns into a byt
9e50: 65 20 61 72 72 61 79 0a 69 6e 20 74 68 65 20 72 e array.in the r
9e60: 65 63 6f 72 64 20 66 6f 72 6d 61 74 2c 20 74 68 ecord format, th
9e70: 65 6e 20 73 74 6f 72 69 6e 67 20 74 68 61 74 20 en storing that
9e80: 62 79 74 65 20 61 72 72 61 79 20 61 73 20 74 68 byte array as th
9e90: 65 20 70 61 79 6c 6f 61 64 20 69 6e 0a 61 6e 20 e payload in.an
9ea0: 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61 62 entry in the tab
9eb0: 6c 65 20 62 2d 74 72 65 65 2e 20 20 54 68 65 20 le b-tree. The
9ec0: 6f 72 64 65 72 20 6f 66 20 76 61 6c 75 65 73 20 order of values
9ed0: 69 6e 20 74 68 65 20 72 65 63 6f 72 64 20 69 73 in the record is
9ee0: 0a 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 .the same as the
9ef0: 20 6f 72 64 65 72 20 6f 66 20 63 6f 6c 75 6d 6e order of column
9f00: 73 20 69 6e 20 74 68 65 20 53 51 4c 20 74 61 62 s in the SQL tab
9f10: 6c 65 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 57 le definition..W
9f20: 68 65 6e 20 61 6e 20 53 51 4c 20 74 61 62 6c 65 hen an SQL table
9f30: 20 74 68 61 74 20 69 6e 63 6c 75 64 65 73 20 61 that includes a
9f40: 6e 0a 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41 n.[INTEGER PRIMA
9f50: 52 59 20 4b 45 59 5d 20 63 6f 6c 75 6d 6e 20 28 RY KEY] column (
9f60: 77 68 69 63 68 20 61 6c 69 61 73 65 73 20 74 68 which aliases th
9f70: 65 20 5b 72 6f 77 69 64 5d 29 20 74 68 65 6e 20 e [rowid]) then
9f80: 74 68 61 74 0a 63 6f 6c 75 6d 6e 20 61 70 70 65 that.column appe
9f90: 61 72 73 20 69 6e 20 74 68 65 20 72 65 63 6f 72 ars in the recor
9fa0: 64 20 61 73 20 61 20 4e 55 4c 4c 20 76 61 6c 75 d as a NULL valu
9fb0: 65 2e 20 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 e. SQLite will
9fc0: 6b 6e 6f 77 20 74 6f 20 75 73 65 0a 74 68 65 20 know to use.the
9fd0: 74 61 62 6c 65 20 62 2d 74 72 65 65 20 6b 65 79 table b-tree key
9fe0: 20 72 61 74 68 65 72 20 74 68 61 6e 20 74 68 65 rather than the
9ff0: 20 4e 55 4c 4c 20 76 61 6c 75 65 20 77 68 65 6e NULL value when
a000: 20 72 65 66 65 72 65 6e 63 69 6e 67 20 74 68 65 referencing the
a010: 0a 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 .[INTEGER PRIMAR
a020: 59 20 4b 45 59 5d 20 63 6f 6c 75 6d 6e 2e 3c 2f Y KEY] column.</
a030: 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20 5b 61 p>..<p>If the [a
a040: 66 66 69 6e 69 74 79 5d 20 6f 66 20 61 20 63 6f ffinity] of a co
a050: 6c 75 6d 6e 20 69 73 20 52 45 41 4c 20 61 6e 64 lumn is REAL and
a060: 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20 63 6f 6e that column con
a070: 74 61 69 6e 73 20 61 0a 76 61 6c 75 65 20 74 68 tains a.value th
a080: 61 74 20 63 61 6e 20 62 65 20 63 6f 6e 76 65 72 at can be conver
a090: 74 65 64 20 74 6f 20 61 6e 20 69 6e 74 65 67 65 ted to an intege
a0a0: 72 20 77 69 74 68 6f 75 74 20 6c 6f 73 73 20 6f r without loss o
a0b0: 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 28 69 f information.(i
a0c0: 66 20 74 68 65 20 76 61 6c 75 65 20 63 6f 6e 74 f the value cont
a0d0: 61 69 6e 73 20 6e 6f 20 66 72 61 63 74 69 6f 6e ains no fraction
a0e0: 61 6c 20 70 61 72 74 20 61 6e 64 20 69 73 20 6e al part and is n
a0f0: 6f 74 20 74 6f 6f 20 6c 61 72 67 65 20 74 6f 20 ot too large to
a100: 62 65 0a 72 65 70 72 65 73 65 6e 74 65 64 20 61 be.represented a
a110: 73 20 61 6e 20 69 6e 74 65 67 65 72 29 20 74 68 s an integer) th
a120: 65 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6d 61 en the column ma
a130: 79 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 74 y be stored in t
a140: 68 65 20 72 65 63 6f 72 64 0a 61 73 20 61 6e 20 he record.as an
a150: 69 6e 74 65 67 65 72 2e 20 20 53 51 4c 69 74 65 integer. SQLite
a160: 20 77 69 6c 6c 20 6b 6e 6f 77 20 74 6f 20 63 6f will know to co
a170: 6e 76 65 72 74 20 74 68 65 20 76 61 6c 75 65 20 nvert the value
a180: 62 61 63 6b 20 74 6f 20 66 6c 6f 61 74 69 6e 67 back to floating
a190: 0a 70 6f 69 6e 74 20 77 68 65 6e 20 65 78 74 72 .point when extr
a1a0: 61 63 74 69 6e 67 20 69 74 20 66 72 6f 6d 20 74 acting it from t
a1b0: 68 65 20 72 65 63 6f 72 64 2e 3c 2f 70 3e 0a 0a he record.</p>..
a1c0: 0a 3c 68 33 3e 32 2e 34 20 52 65 70 72 65 73 65 .<h3>2.4 Represe
a1d0: 6e 74 61 74 69 6f 6e 20 4f 66 20 53 51 4c 20 49 ntation Of SQL I
a1e0: 6e 64 69 63 65 73 3c 2f 68 33 3e 0a 0a 3c 70 3e ndices</h3>..<p>
a1f0: 45 61 63 68 20 53 51 4c 20 69 6e 64 65 78 2c 20 Each SQL index,
a200: 77 68 65 74 68 65 72 20 65 78 70 6c 69 63 69 74 whether explicit
a210: 6c 79 20 64 65 63 6c 61 72 65 64 20 76 69 61 20 ly declared via
a220: 61 20 5b 43 52 45 41 54 45 20 49 4e 44 45 58 5d a [CREATE INDEX]
a230: 20 73 74 61 74 65 6d 65 6e 74 0a 6f 72 20 69 6d statement.or im
a240: 70 6c 69 65 64 20 62 79 20 61 20 55 4e 49 51 55 plied by a UNIQU
a250: 45 20 63 6f 6e 73 74 72 61 69 6e 74 2c 20 63 6f E constraint, co
a260: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 61 6e 20 rresponds to an
a270: 69 6e 64 65 78 20 62 2d 74 72 65 65 20 69 6e 20 index b-tree in
a280: 74 68 65 0a 64 61 74 61 62 61 73 65 20 66 69 6c the.database fil
a290: 65 2e 0a 54 68 65 72 65 20 69 73 20 6f 6e 65 20 e..There is one
a2a0: 65 6e 74 72 79 20 69 6e 20 69 6e 64 65 78 20 62 entry in index b
a2b0: 2d 74 72 65 65 20 66 6f 72 20 65 61 63 68 20 72 -tree for each r
a2c0: 6f 77 20 69 6e 20 74 68 65 20 63 6f 72 72 65 73 ow in the corres
a2d0: 70 6f 6e 64 69 6e 67 20 74 61 62 6c 65 2e 0a 54 ponding table..T
a2e0: 68 65 20 6b 65 79 20 74 6f 20 61 6e 20 69 6e 64 he key to an ind
a2f0: 65 78 20 62 2d 74 72 65 65 20 69 73 0a 61 20 72 ex b-tree is.a r
a300: 65 63 6f 72 64 20 63 6f 6d 70 6f 73 65 64 20 6f ecord composed o
a310: 66 20 74 68 65 20 63 6f 6c 75 6d 6e 73 20 74 68 f the columns th
a320: 61 74 20 61 72 65 20 62 65 69 6e 67 20 69 6e 64 at are being ind
a330: 65 78 65 64 20 66 6f 6c 6c 6f 77 65 64 20 62 79 exed followed by
a340: 20 74 68 65 0a 5b 72 6f 77 69 64 5d 20 6f 66 20 the.[rowid] of
a350: 74 68 65 20 74 61 62 6c 65 20 72 6f 77 2e 20 20 the table row.
a360: 42 65 63 61 75 73 65 20 65 76 65 72 79 20 72 6f Because every ro
a370: 77 20 69 6e 20 61 20 74 61 62 6c 65 20 68 61 73 w in a table has
a380: 20 61 20 75 6e 69 71 75 65 0a 72 6f 77 69 64 20 a unique.rowid
a390: 61 6e 64 20 61 6c 6c 20 6b 65 79 73 20 69 6e 20 and all keys in
a3a0: 61 6e 20 69 6e 64 65 78 20 63 6f 6e 74 61 69 6e an index contain
a3b0: 20 74 68 65 20 72 6f 77 69 64 2c 20 61 6c 6c 20 the rowid, all
a3c0: 6b 65 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 keys in an index
a3d0: 0a 61 72 65 20 75 6e 69 71 75 65 2e 3c 2f 70 3e .are unique.</p>
a3e0: 0a 0a 3c 70 3e 54 68 65 72 65 20 69 73 20 61 20 ..<p>There is a
a3f0: 6f 6e 65 2d 74 6f 2d 6f 6e 65 20 6d 61 70 70 69 one-to-one mappi
a400: 6e 67 20 62 65 74 77 65 65 6e 20 72 6f 77 73 20 ng between rows
a410: 69 6e 20 61 20 74 61 62 6c 65 20 61 6e 64 0a 65 in a table and.e
a420: 6e 74 72 69 65 73 20 69 6e 20 65 61 63 68 20 69 ntries in each i
a430: 6e 64 65 78 20 61 73 73 6f 63 69 61 74 65 64 20 ndex associated
a440: 77 69 74 68 20 74 68 61 74 20 74 61 62 6c 65 2e with that table.
a450: 0a 43 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 72 .Corresponding r
a460: 6f 77 73 20 69 6e 74 20 74 68 65 20 69 6e 64 65 ows int the inde
a470: 78 20 61 6e 64 20 74 61 62 6c 65 20 62 2d 74 72 x and table b-tr
a480: 65 65 73 20 73 68 61 72 65 20 74 68 65 20 73 61 ees share the sa
a490: 6d 65 20 72 6f 77 69 64 0a 76 61 6c 75 65 2c 20 me rowid.value,
a4a0: 61 6e 64 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 and contain the
a4b0: 73 61 6d 65 20 76 61 6c 75 65 20 66 6f 72 20 61 same value for a
a4c0: 6c 6c 20 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d ll indexed colum
a4d0: 6e 73 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 35 ns.</p>..<h3>2.5
a4e0: 20 53 74 6f 72 61 67 65 20 4f 66 20 54 68 65 20 Storage Of The
a4f0: 53 51 4c 20 44 61 74 61 62 61 73 65 20 53 63 68 SQL Database Sch
a500: 65 6d 61 3c 2f 68 33 3e 0a 0a 3c 70 3e 50 61 67 ema</h3>..<p>Pag
a510: 65 20 31 20 6f 66 20 61 20 64 61 74 61 62 61 73 e 1 of a databas
a520: 65 20 66 69 6c 65 20 69 73 20 74 68 65 20 72 6f e file is the ro
a530: 6f 74 20 70 61 67 65 20 6f 66 20 61 20 74 61 62 ot page of a tab
a540: 6c 65 20 62 2d 74 72 65 65 20 74 68 61 74 0a 68 le b-tree that.h
a550: 6f 6c 64 73 20 61 20 73 70 65 63 69 61 6c 20 74 olds a special t
a560: 61 62 6c 65 20 6e 61 6d 65 64 20 22 73 71 6c 69 able named "sqli
a570: 74 65 5f 6d 61 73 74 65 72 22 20 28 6f 72 20 22 te_master" (or "
a580: 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 sqlite_temp_mast
a590: 65 72 22 20 69 6e 0a 74 68 65 20 63 61 73 65 20 er" in.the case
a5a0: 6f 66 20 61 20 54 45 4d 50 20 64 61 74 61 62 61 of a TEMP databa
a5b0: 73 65 29 20 77 68 69 63 68 20 73 74 6f 72 65 73 se) which stores
a5c0: 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 0a 64 61 the complete.da
a5d0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 20 tabase schema.
a5e0: 54 68 65 20 73 74 72 75 63 74 75 72 65 20 6f 66 The structure of
a5f0: 20 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 the sqlite_mast
a600: 65 72 20 74 61 62 6c 65 20 69 73 20 61 73 0a 69 er table is as.i
a610: 66 20 69 74 20 68 61 64 20 62 65 65 6e 20 63 72 f it had been cr
a620: 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 65 20 eated using the
a630: 66 6f 6c 6c 6f 77 69 6e 67 20 53 51 4c 3a 3c 2f following SQL:</
a640: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e p>..<blockquote>
a650: 3c 70 72 65 3e 0a 43 52 45 41 54 45 20 54 41 42 <pre>.CREATE TAB
a660: 4c 45 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 LE sqlite_master
a670: 28 0a 20 20 74 79 70 65 20 74 65 78 74 2c 0a 20 (. type text,.
a680: 20 6e 61 6d 65 20 74 65 78 74 2c 0a 20 20 74 62 name text,. tb
a690: 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 0a 20 20 72 l_name text,. r
a6a0: 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72 2c ootpage integer,
a6b0: 0a 20 20 73 71 6c 20 74 65 78 74 0a 29 3b 0a 3c . sql text.);.<
a6c0: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 /pre></blockquot
a6d0: 65 3e 0a 0a 3c 70 3e 54 68 65 20 73 71 6c 69 74 e>..<p>The sqlit
a6e0: 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 20 63 e_master table c
a6f0: 6f 6e 74 61 69 6e 73 20 61 20 72 6f 77 20 66 6f ontains a row fo
a700: 72 20 65 61 63 68 20 74 61 62 6c 65 2c 20 69 6e r each table, in
a710: 64 65 78 2c 20 76 69 65 77 2c 0a 61 6e 64 20 74 dex, view,.and t
a720: 72 69 67 67 65 72 20 69 6e 20 74 68 65 20 64 61 rigger in the da
a730: 74 61 62 61 73 65 20 73 63 68 65 6d 61 2c 20 65 tabase schema, e
a740: 78 63 65 70 74 20 74 68 65 72 65 20 69 73 20 6e xcept there is n
a750: 6f 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 0a o entry for the.
a760: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 74 61 sqlite_master ta
a770: 62 6c 65 20 69 74 73 65 6c 66 2e 3c 2f 70 3e 0a ble itself.</p>.
a780: 0a 3c 70 3e 54 68 65 20 73 71 6c 69 74 65 5f 6d .<p>The sqlite_m
a790: 61 73 74 65 72 2e 74 79 70 65 20 63 6f 6c 75 6d aster.type colum
a7a0: 6e 20 77 69 6c 6c 20 62 65 20 6f 6e 65 0a 6f 66 n will be one.of
a7b0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 the following t
a7c0: 65 78 74 20 73 74 72 69 6e 67 73 3a 20 20 27 74 ext strings: 't
a7d0: 61 62 6c 65 27 2c 20 27 69 6e 64 65 78 27 2c 20 able', 'index',
a7e0: 27 76 69 65 77 27 2c 20 6f 72 20 27 74 72 69 67 'view', or 'trig
a7f0: 67 65 72 27 0a 61 63 63 6f 72 64 69 6e 67 20 74 ger'.according t
a800: 6f 20 74 68 65 20 74 79 70 65 20 6f 66 20 6f 62 o the type of ob
a810: 6a 65 63 74 20 64 65 66 69 6e 65 64 2e 20 20 54 ject defined. T
a820: 68 65 20 27 74 61 62 6c 65 27 20 73 74 72 69 6e he 'table' strin
a830: 67 20 69 73 20 75 73 65 64 0a 66 6f 72 20 62 6f g is used.for bo
a840: 74 68 20 6f 72 64 69 6e 61 72 79 20 61 6e 64 20 th ordinary and
a850: 5b 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 5d [virtual tables]
a860: 2e 3c 2f 70 3e 0a 0a 3c 2f 70 3e 54 68 65 20 73 .</p>..</p>The s
a870: 71 6c 69 74 65 5f 6d 61 73 74 65 72 2e 6e 61 6d qlite_master.nam
a880: 65 20 63 6f 6c 75 6d 6e 20 77 69 6c 6c 20 68 6f e column will ho
a890: 6c 64 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 ld the name of t
a8a0: 68 65 20 6f 62 6a 65 63 74 2e 0a 46 6f 72 20 69 he object..For i
a8b0: 6e 64 69 63 65 73 20 74 68 61 74 20 61 72 65 20 ndices that are
a8c0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 72 automatically cr
a8d0: 65 61 74 65 64 20 62 79 20 55 4e 49 51 55 45 20 eated by UNIQUE
a8e0: 63 6f 6e 73 74 72 61 69 6e 74 73 2c 20 74 68 65 constraints, the
a8f0: 0a 6e 61 6d 65 20 69 73 20 22 73 71 6c 69 74 65 .name is "sqlite
a900: 5f 61 75 74 6f 69 6e 64 65 78 5f 54 41 42 4c 45 _autoindex_TABLE
a910: 5f 4e 22 20 77 68 65 72 65 20 54 41 42 4c 45 20 _N" where TABLE
a920: 69 73 20 72 65 70 6c 61 63 65 64 20 62 79 20 74 is replaced by t
a930: 68 65 20 6e 61 6d 65 0a 6f 66 20 74 68 65 20 74 he name.of the t
a940: 61 62 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 69 able that contai
a950: 6e 73 20 74 68 65 20 55 4e 49 51 55 45 20 63 6f ns the UNIQUE co
a960: 6e 73 74 72 61 69 6e 74 20 61 6e 64 20 4e 20 69 nstraint and N i
a970: 73 20 61 6e 20 69 6e 74 65 67 65 72 20 62 65 67 s an integer beg
a980: 69 6e 6e 69 6e 67 0a 77 69 74 68 20 31 20 61 6e inning.with 1 an
a990: 64 20 69 6e 63 72 65 61 73 69 6e 67 20 62 79 20 d increasing by
a9a0: 6f 6e 65 20 77 69 74 68 20 65 61 63 68 20 55 4e one with each UN
a9b0: 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 IQUE constraint
a9c0: 73 65 65 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 seen.</p>..<p>Th
a9d0: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 2e e sqlite_master.
a9e0: 74 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 tbl_name column
a9f0: 68 6f 6c 64 73 20 74 68 65 20 6e 61 6d 65 20 6f holds the name o
aa00: 66 20 61 20 74 61 62 6c 65 20 6f 72 20 76 69 65 f a table or vie
aa10: 77 0a 74 68 61 74 20 74 68 65 20 6f 62 6a 65 63 w.that the objec
aa20: 74 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 t is associated
aa30: 77 69 74 68 2e 20 20 46 6f 72 20 61 20 74 61 62 with. For a tab
aa40: 6c 65 20 6f 72 20 76 69 65 77 2c 20 74 68 65 0a le or view, the.
aa50: 74 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 tbl_name column
aa60: 69 73 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 is a copy of the
aa70: 20 6e 61 6d 65 20 63 6f 6c 75 6d 6e 2e 20 20 46 name column. F
aa80: 6f 72 20 61 6e 20 69 6e 64 65 78 2c 20 74 68 65 or an index, the
aa90: 20 74 62 6c 5f 6e 61 6d 65 0a 69 73 20 74 68 65 tbl_name.is the
aaa0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
aab0: 6c 65 20 74 68 61 74 20 69 73 20 69 6e 64 65 78 le that is index
aac0: 65 64 2e 20 20 46 6f 72 20 61 20 74 72 69 67 67 ed. For a trigg
aad0: 65 72 2c 20 74 68 65 20 74 62 6c 5f 6e 61 6d 65 er, the tbl_name
aae0: 0a 63 6f 6c 75 6d 6e 20 73 74 6f 72 65 73 20 74 .column stores t
aaf0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 he name of the t
ab00: 61 62 6c 65 20 6f 72 20 76 69 65 77 20 74 68 61 able or view tha
ab10: 74 20 63 61 75 73 65 73 20 74 68 65 20 74 72 69 t causes the tri
ab20: 67 67 65 72 20 0a 74 6f 20 66 69 72 65 2e 3c 2f gger .to fire.</
ab30: 70 3e 0a 0a 3c 70 3e 54 68 65 20 73 71 6c 69 74 p>..<p>The sqlit
ab40: 65 5f 6d 61 73 74 65 72 2e 72 6f 6f 74 70 61 67 e_master.rootpag
ab50: 65 20 63 6f 6c 75 6d 6e 20 73 74 6f 72 65 73 20 e column stores
ab60: 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
ab70: 6f 66 20 74 68 65 20 72 6f 6f 74 0a 62 2d 74 72 of the root.b-tr
ab80: 65 65 20 70 61 67 65 20 66 6f 72 20 74 61 62 6c ee page for tabl
ab90: 65 73 20 61 6e 64 20 69 6e 64 69 63 65 73 2e 20 es and indices.
aba0: 20 46 6f 72 20 72 6f 77 73 20 74 68 61 74 20 64 For rows that d
abb0: 65 66 69 6e 65 20 76 69 65 77 73 2c 20 74 72 69 efine views, tri
abc0: 67 67 65 72 73 2c 0a 61 6e 64 20 76 69 72 74 75 ggers,.and virtu
abd0: 61 6c 20 74 61 62 6c 65 73 2c 20 74 68 65 20 72 al tables, the r
abe0: 6f 6f 74 70 61 67 65 20 63 6f 6c 75 6d 6e 20 69 ootpage column i
abf0: 73 20 30 20 6f 72 20 4e 55 4c 4c 2e 3c 2f 70 3e s 0 or NULL.</p>
ac00: 0a 0a 3c 70 3e 54 68 65 20 73 71 6c 69 74 65 5f ..<p>The sqlite_
ac10: 6d 61 73 74 65 72 2e 73 71 6c 20 63 6f 6c 75 6d master.sql colum
ac20: 6e 20 73 74 6f 72 65 73 20 53 51 4c 20 74 65 78 n stores SQL tex
ac30: 74 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 t that describes
ac40: 20 74 68 65 0a 6f 62 6a 65 63 74 2e 20 20 54 68 the.object. Th
ac50: 69 73 20 53 51 4c 20 74 65 78 74 20 69 73 20 61 is SQL text is a
ac60: 20 5b 43 52 45 41 54 45 20 54 41 42 4c 45 5d 2c [CREATE TABLE],
ac70: 20 5b 43 52 45 41 54 45 20 56 49 52 54 55 41 4c [CREATE VIRTUAL
ac80: 20 54 41 42 4c 45 5d 2c 0a 5b 43 52 45 41 54 45 TABLE],.[CREATE
ac90: 20 49 4e 44 45 58 5d 2c 0a 5b 43 52 45 41 54 45 INDEX],.[CREATE
aca0: 20 56 49 45 57 5d 2c 20 6f 72 20 5b 43 52 45 41 VIEW], or [CREA
acb0: 54 45 20 54 52 49 47 47 45 52 5d 20 73 74 61 74 TE TRIGGER] stat
acc0: 65 6d 65 6e 74 20 74 68 61 74 20 69 66 20 65 76 ement that if ev
acd0: 61 6c 75 61 74 65 64 20 61 67 61 69 6e 73 74 0a aluated against.
ace0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
acf0: 65 20 77 68 65 6e 20 69 74 20 69 73 20 74 68 65 e when it is the
ad00: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 6f main database o
ad10: 66 20 61 20 5b 64 61 74 61 62 61 73 65 20 63 6f f a [database co
ad20: 6e 6e 65 63 74 69 6f 6e 5d 0a 77 6f 75 6c 64 20 nnection].would
ad30: 72 65 63 72 65 61 74 65 64 20 74 68 65 20 6f 62 recreated the ob
ad40: 6a 65 63 74 2e 20 20 54 68 65 20 74 65 78 74 20 ject. The text
ad50: 69 73 20 75 73 75 61 6c 6c 79 20 61 20 63 6f 70 is usually a cop
ad60: 79 20 6f 66 20 74 68 65 20 6f 72 69 67 69 6e 61 y of the origina
ad70: 6c 0a 73 74 61 74 65 6d 65 6e 74 20 75 73 65 64 l.statement used
ad80: 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 6f to create the o
ad90: 62 6a 65 63 74 20 62 75 74 20 77 69 74 68 20 6e bject but with n
ada0: 6f 72 6d 61 6c 69 7a 61 74 69 6f 6e 73 20 61 70 ormalizations ap
adb0: 70 6c 69 65 64 20 73 6f 0a 74 68 61 74 20 74 68 plied so.that th
adc0: 65 20 74 65 78 74 20 63 6f 6e 66 6f 72 6d 73 20 e text conforms
add0: 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 to the following
ade0: 20 72 75 6c 65 73 3a 0a 0a 3c 75 6c 3e 0a 3c 6c rules:..<ul>.<l
adf0: 69 3e 54 68 65 20 43 52 45 41 54 45 2c 20 54 41 i>The CREATE, TA
ae00: 42 4c 45 2c 20 56 49 45 57 2c 20 54 52 49 47 47 BLE, VIEW, TRIGG
ae10: 45 52 2c 20 61 6e 64 20 49 4e 44 45 58 20 6b 65 ER, and INDEX ke
ae20: 79 77 6f 72 64 73 20 61 74 20 74 68 65 20 62 65 ywords at the be
ae30: 67 69 6e 6e 69 6e 67 0a 6f 66 20 74 68 65 20 73 ginning.of the s
ae40: 74 61 74 65 6d 65 6e 74 20 61 72 65 20 63 6f 6e tatement are con
ae50: 76 65 72 74 65 64 20 74 6f 20 61 6c 6c 20 75 70 verted to all up
ae60: 70 65 72 20 63 61 73 65 20 6c 65 74 74 65 72 73 per case letters
ae70: 2e 0a 3c 6c 69 3e 54 68 65 20 54 45 4d 50 20 6f ..<li>The TEMP o
ae80: 72 20 54 45 4d 50 4f 52 41 52 59 20 6b 65 79 77 r TEMPORARY keyw
ae90: 6f 72 64 20 69 73 20 72 65 6d 6f 76 65 64 20 69 ord is removed i
aea0: 66 20 69 74 20 6f 63 63 75 72 73 20 61 66 74 65 f it occurs afte
aeb0: 72 20 74 68 65 20 0a 69 6e 69 74 69 61 6c 20 43 r the .initial C
aec0: 52 45 41 54 45 20 6b 65 79 77 6f 72 64 2e 0a 3c REATE keyword..<
aed0: 6c 69 3e 41 6e 79 20 64 61 74 61 62 61 73 65 20 li>Any database
aee0: 6e 61 6d 65 20 71 75 61 6c 69 66 69 65 72 20 74 name qualifier t
aef0: 68 61 74 20 6f 63 63 75 72 73 20 70 72 69 6f 72 hat occurs prior
af00: 20 74 6f 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 to the name of
af10: 74 68 65 0a 6f 62 6a 65 63 74 20 62 65 69 6e 67 the.object being
af20: 20 63 72 65 61 74 65 64 20 69 73 20 72 65 6d 6f created is remo
af30: 76 65 64 2e 0a 3c 6c 69 3e 4c 65 61 64 69 6e 67 ved..<li>Leading
af40: 20 73 70 61 63 65 73 20 61 72 65 20 72 65 6d 6f spaces are remo
af50: 76 65 64 2e 0a 3c 6c 69 3e 41 6c 6c 20 73 70 61 ved..<li>All spa
af60: 63 65 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 ces following th
af70: 65 20 66 69 72 73 74 20 74 77 6f 20 6b 65 79 77 e first two keyw
af80: 6f 72 64 73 20 61 72 65 20 63 6f 6e 76 65 72 74 ords are convert
af90: 65 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 ed into a single
afa0: 0a 73 70 61 63 65 2e 0a 3c 2f 75 6c 3e 0a 0a 3c .space..</ul>..<
afb0: 70 3e 54 68 65 20 74 65 78 74 20 69 6e 20 74 68 p>The text in th
afc0: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 2e e sqlite_master.
afd0: 73 71 6c 20 63 6f 6c 75 6d 6e 20 69 73 20 61 20 sql column is a
afe0: 63 6f 70 79 20 6f 66 20 74 68 65 20 6f 72 69 67 copy of the orig
aff0: 69 6e 61 6c 0a 43 52 45 41 54 45 20 73 74 61 74 inal.CREATE stat
b000: 65 6d 65 6e 74 20 74 65 78 74 20 74 68 61 74 20 ement text that
b010: 63 72 65 61 74 65 64 20 74 68 65 20 6f 62 6a 65 created the obje
b020: 63 74 2c 20 65 78 63 65 70 74 20 6e 6f 72 6d 61 ct, except norma
b030: 6c 69 7a 65 64 20 61 73 0a 64 65 73 63 72 69 62 lized as.describ
b040: 65 64 20 61 62 6f 76 65 20 61 6e 64 20 61 73 20 ed above and as
b050: 6d 6f 64 69 66 69 65 64 20 62 79 20 73 75 62 73 modified by subs
b060: 65 71 75 65 6e 74 20 5b 41 4c 54 45 52 20 54 41 equent [ALTER TA
b070: 42 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74 73 2e BLE] statements.
b080: 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 72 20 69 6e 64 </p>..<p>For ind
b090: 69 63 65 73 20 74 68 61 74 20 61 72 65 20 61 75 ices that are au
b0a0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 72 65 61 tomatically crea
b0b0: 74 65 64 20 62 79 20 55 4e 49 51 55 45 20 63 6f ted by UNIQUE co
b0c0: 6e 73 74 72 61 69 6e 74 73 2c 0a 74 68 65 20 73 nstraints,.the s
b0d0: 71 6c 69 74 65 5f 6d 61 73 74 65 72 2e 73 71 6c qlite_master.sql
b0e0: 20 66 69 65 6c 64 20 69 73 20 4e 55 4c 4c 2e 3c field is NULL.<
b0f0: 2f 70 3e 0a 0a 0a 3c 74 63 6c 3e 68 64 5f 66 72 /p>...<tcl>hd_fr
b100: 61 67 6d 65 6e 74 20 72 6f 6c 6c 62 61 63 6b 6a agment rollbackj
b110: 6f 75 72 6e 61 6c 20 7b 72 6f 6c 6c 62 61 63 6b ournal {rollback
b120: 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 7d journal format}
b130: 3c 2f 74 63 6c 3e 0a 3c 68 32 3e 33 2e 30 20 54 </tcl>.<h2>3.0 T
b140: 68 65 20 52 6f 6c 6c 62 61 63 6b 20 4a 6f 75 72 he Rollback Jour
b150: 6e 61 6c 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 nal</h2>..<p>The
b160: 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
b170: 6c 20 69 73 20 61 20 66 69 6c 65 20 61 73 73 6f l is a file asso
b180: 63 69 61 74 65 64 20 77 69 74 68 20 65 61 63 68 ciated with each
b190: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
b1a0: 0a 66 61 69 6c 20 74 68 61 74 20 68 6f 6c 64 20 .fail that hold
b1b0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 information used
b1c0: 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 to restore the
b1d0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f database file to
b1e0: 20 69 74 73 20 69 6e 69 74 69 61 6c 0a 73 74 61 its initial.sta
b1f0: 74 65 20 64 75 72 69 6e 67 20 74 68 65 20 63 6f te during the co
b200: 75 72 73 65 20 6f 66 20 61 20 74 72 61 6e 73 61 urse of a transa
b210: 63 74 69 6f 6e 2e 0a 54 68 65 20 72 6f 6c 6c 62 ction..The rollb
b220: 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ack journal file
b230: 20 69 73 20 61 6c 77 61 79 73 20 6c 6f 63 61 74 is always locat
b240: 65 64 20 69 6e 20 74 68 65 20 64 69 72 65 63 74 ed in the direct
b250: 6f 72 79 20 61 73 20 74 68 65 20 64 61 74 61 62 ory as the datab
b260: 61 73 65 0a 66 69 6c 65 20 61 6e 64 20 68 61 73 ase.file and has
b270: 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 the same name a
b280: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 s the database f
b290: 69 6c 65 20 62 75 74 20 77 69 74 68 20 74 68 65 ile but with the
b2a0: 20 73 74 72 69 6e 67 0a 22 3c 74 74 3e 2d 6a 6f string."<tt>-jo
b2b0: 75 72 6e 61 6c 3c 2f 74 74 3e 22 20 61 70 70 65 urnal</tt>" appe
b2c0: 6e 64 65 64 2e 20 20 54 68 65 72 65 20 63 61 6e nded. There can
b2d0: 20 6f 6e 6c 79 20 62 65 20 61 20 73 69 6e 67 6c only be a singl
b2e0: 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
b2f0: 61 6c 0a 61 73 73 6f 63 69 61 74 65 64 20 77 69 al.associated wi
b300: 74 68 20 61 20 67 69 76 65 20 64 61 74 61 62 61 th a give databa
b310: 73 65 20 61 6e 64 20 68 65 6e 63 65 20 74 68 65 se and hence the
b320: 72 65 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 6f re can only be o
b330: 6e 65 20 77 72 69 74 65 0a 74 72 61 6e 73 61 63 ne write.transac
b340: 74 69 6f 6e 20 6f 70 65 6e 20 61 67 61 69 6e 73 tion open agains
b350: 74 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 62 t a single datab
b360: 61 73 65 20 61 74 20 6f 6e 65 20 74 69 6d 65 2e ase at one time.
b370: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 20 74 72 </p>..<p>If a tr
b380: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 62 6f ansaction is abo
b390: 72 74 65 64 20 64 75 65 20 74 6f 20 61 6e 20 61 rted due to an a
b3a0: 70 70 6c 69 63 61 74 69 6f 6e 20 63 72 61 73 68 pplication crash
b3b0: 2c 20 61 6e 20 6f 70 65 72 61 74 69 6e 67 0a 73 , an operating.s
b3c0: 79 73 74 65 6d 20 63 72 61 73 68 2c 20 6f 72 20 ystem crash, or
b3d0: 61 20 68 61 72 64 77 61 72 65 20 70 6f 77 65 72 a hardware power
b3e0: 20 66 61 69 6c 75 72 65 20 6f 72 20 63 72 61 73 failure or cras
b3f0: 68 2c 20 74 68 65 6e 20 74 68 65 20 64 61 74 61 h, then the data
b400: 62 61 73 65 20 6d 61 79 0a 62 65 20 6c 65 66 74 base may.be left
b410: 20 69 6e 20 61 6e 20 69 6e 63 6f 6e 73 69 73 74 in an inconsist
b420: 65 6e 74 20 73 74 61 74 65 2e 20 20 54 68 65 20 ent state. The
b430: 6e 65 78 74 20 74 69 6d 65 20 53 51 4c 69 74 65 next time SQLite
b440: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 6f 70 65 attempts to ope
b450: 6e 0a 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n.the database f
b460: 69 6c 65 2c 20 74 68 65 20 70 72 65 73 65 6e 63 ile, the presenc
b470: 65 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 61 63 e of the rollbac
b480: 6b 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 k journal file w
b490: 69 6c 6c 20 62 65 20 0a 64 65 74 65 63 74 65 64 ill be .detected
b4a0: 20 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c and the journal
b4b0: 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 will be automat
b4c0: 69 63 61 6c 6c 79 20 70 6c 61 79 65 64 20 62 61 ically played ba
b4d0: 63 6b 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 ck to restore th
b4e0: 65 0a 64 61 74 61 62 61 73 65 20 74 6f 20 69 74 e.database to it
b4f0: 73 20 73 74 61 74 65 20 61 74 20 74 68 65 20 73 s state at the s
b500: 74 61 72 74 20 6f 66 20 74 68 65 20 69 6e 63 6f tart of the inco
b510: 6d 70 6c 65 74 65 20 74 72 61 6e 73 61 63 74 69 mplete transacti
b520: 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 72 6f on.</p>..<p>A ro
b530: 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 69 llback journal i
b540: 73 20 6f 6e 6c 79 20 63 6f 6e 73 69 64 65 72 65 s only considere
b550: 64 20 74 6f 20 62 65 20 76 61 6c 69 64 20 69 66 d to be valid if
b560: 20 69 74 20 65 78 69 73 74 73 20 61 6e 64 0a 63 it exists and.c
b570: 6f 6e 74 61 69 6e 73 20 61 20 76 61 6c 69 64 20 ontains a valid
b580: 68 65 61 64 65 72 2e 20 20 48 65 6e 63 65 20 61 header. Hence a
b590: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 6e transaction can
b5a0: 20 62 65 20 63 6f 6d 6d 69 74 74 65 64 20 69 6e be committed in
b5b0: 20 6f 6e 65 0a 6f 66 20 74 68 72 65 65 20 77 61 one.of three wa
b5c0: 79 73 3a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 54 68 65 ys:.<ol>.<li>The
b5d0: 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
b5e0: 6c 20 66 69 6c 65 20 63 61 6e 20 62 65 20 64 65 l file can be de
b5f0: 6c 65 74 65 64 2c 0a 3c 6c 69 3e 54 68 65 20 72 leted,.<li>The r
b600: 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 ollback journal
b610: 66 69 6c 65 20 63 61 6e 20 62 65 20 74 72 75 6e file can be trun
b620: 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 6c 65 cated to zero le
b630: 6e 67 74 68 2c 20 6f 72 0a 3c 6c 69 3e 54 68 65 ngth, or.<li>The
b640: 20 68 65 61 64 65 72 20 6f 66 20 74 68 65 20 72 header of the r
b650: 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 ollback journal
b660: 63 61 6e 20 62 65 20 6f 76 65 72 77 72 69 74 74 can be overwritt
b670: 65 6e 20 77 69 74 68 0a 69 6e 76 61 6c 69 64 20 en with.invalid
b680: 68 65 61 64 65 72 20 74 65 78 74 20 28 66 6f 72 header text (for
b690: 20 65 78 61 6d 70 6c 65 2c 20 61 6c 6c 20 7a 65 example, all ze
b6a0: 72 6f 73 29 2e 0a 3c 2f 6f 6c 3e 0a 54 68 65 73 ros)..</ol>.Thes
b6b0: 65 20 74 68 72 65 65 20 77 61 79 73 20 6f 66 20 e three ways of
b6c0: 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 74 72 61 committing a tra
b6d0: 6e 73 61 63 74 69 6f 6e 20 63 6f 72 72 65 73 70 nsaction corresp
b6e0: 6f 6e 64 20 74 6f 20 74 68 65 20 44 45 4c 45 54 ond to the DELET
b6f0: 45 2c 0a 54 52 55 4e 43 41 54 45 2c 20 61 6e 64 E,.TRUNCATE, and
b700: 20 50 45 52 53 49 53 54 20 73 65 74 74 69 6e 67 PERSIST setting
b710: 73 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2c s, respectively,
b720: 20 6f 66 20 74 68 65 20 5b 6a 6f 75 72 6e 61 6c of the [journal
b730: 5f 6d 6f 64 65 20 70 72 61 67 6d 61 5d 2e 0a 3c _mode pragma]..<
b740: 2f 70 3e 0a 0a 0a 3c 70 3e 41 20 76 61 6c 69 64 /p>...<p>A valid
b750: 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 rollback journa
b760: 6c 20 62 65 67 69 6e 73 20 77 69 74 68 20 61 20 l begins with a
b770: 68 65 61 64 65 72 20 69 6e 20 74 68 65 20 66 6f header in the fo
b780: 6c 6c 6f 77 69 6e 67 20 66 6f 72 6d 61 74 3a 3c llowing format:<
b790: 2f 70 3e 0a 0a 3c 63 65 6e 74 65 72 3e 0a 3c 69 /p>..<center>.<i
b7a0: 3e 52 6f 6c 6c 62 61 63 6b 20 4a 6f 75 72 6e 61 >Rollback Journa
b7b0: 6c 20 48 65 61 64 65 72 20 46 6f 72 6d 61 74 3c l Header Format<
b7c0: 2f 69 3e 3c 62 72 3e 0a 3c 74 61 62 6c 65 20 77 /i><br>.<table w
b7d0: 69 64 74 68 3d 22 38 30 25 22 20 62 6f 72 64 65 idth="80%" borde
b7e0: 72 3d 31 3e 0a 3c 74 72 3e 3c 74 68 3e 4f 66 66 r=1>.<tr><th>Off
b7f0: 73 65 74 3c 74 68 3e 53 69 7a 65 3c 74 68 3e 44 set<th>Size<th>D
b800: 65 73 63 72 69 70 74 69 6f 6e 0a 3c 74 72 3e 3c escription.<tr><
b810: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
b820: 69 67 6e 3d 63 65 6e 74 65 72 3e 30 0a 20 20 20 ign=center>0.
b830: 20 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 <td valign=top
b840: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 38 0a 20 align=center>8.
b850: 20 20 20 3c 74 64 3e 48 65 61 64 65 72 20 73 74 <td>Header st
b860: 72 69 6e 67 3a 20 20 30 78 64 39 2c 20 30 78 64 ring: 0xd9, 0xd
b870: 35 2c 20 30 78 30 35 2c 20 30 78 66 39 2c 20 30 5, 0x05, 0xf9, 0
b880: 78 32 30 2c 20 30 78 61 31 2c 20 30 78 36 33 2c x20, 0xa1, 0x63,
b890: 20 30 78 64 37 0a 3c 74 72 3e 3c 74 64 20 76 61 0xd7.<tr><td va
b8a0: 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 lign=top align=c
b8b0: 65 6e 74 65 72 3e 38 0a 20 20 20 20 3c 74 64 20 enter>8. <td
b8c0: 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 67 6e valign=top align
b8d0: 3d 63 65 6e 74 65 72 3e 34 0a 20 20 20 20 3c 74 =center>4. <t
b8e0: 64 3e 54 68 65 20 22 50 61 67 65 20 43 6f 75 6e d>The "Page Coun
b8f0: 74 22 20 2d 20 54 68 65 20 6e 75 6d 62 65 72 20 t" - The number
b900: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 of pages in the
b910: 6e 65 78 74 20 73 65 67 6d 65 6e 74 20 6f 66 20 next segment of
b920: 74 68 65 20 0a 20 20 20 20 20 20 20 20 6a 6f 75 the . jou
b930: 72 6e 61 6c 2c 20 6f 72 20 2d 31 20 74 6f 0a 20 rnal, or -1 to.
b940: 20 20 20 20 20 20 20 6d 65 61 6e 20 61 6c 6c 20 mean all
b950: 63 6f 6e 74 65 6e 74 20 74 6f 20 74 68 65 20 65 content to the e
b960: 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 0a 3c nd of the file.<
b970: 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f tr><td valign=to
b980: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 p align=center>1
b990: 32 0a 20 20 20 20 3c 74 64 20 76 61 6c 69 67 6e 2. <td valign
b9a0: 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 =top align=cente
b9b0: 72 3e 34 0a 20 20 20 20 3c 74 64 3e 41 20 72 61 r>4. <td>A ra
b9c0: 6e 64 6f 6d 20 6e 6f 6e 63 65 20 66 6f 72 20 74 ndom nonce for t
b9d0: 68 65 20 63 68 65 63 6b 73 75 6d 0a 3c 74 72 3e he checksum.<tr>
b9e0: 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 <td valign=top a
b9f0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 31 36 0a 20 lign=center>16.
ba00: 20 20 20 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f <td valign=to
ba10: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 p align=center>4
ba20: 0a 20 20 20 20 3c 74 64 3e 49 6e 69 74 69 61 6c . <td>Initial
ba30: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
ba40: 61 62 61 73 65 20 69 6e 20 70 61 67 65 73 0a 3c abase in pages.<
ba50: 74 72 3e 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f tr><td valign=to
ba60: 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 32 p align=center>2
ba70: 30 0a 20 20 20 20 3c 74 64 20 76 61 6c 69 67 6e 0. <td valign
ba80: 3d 74 6f 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 =top align=cente
ba90: 72 3e 34 0a 20 20 20 20 3c 74 64 3e 53 69 7a 65 r>4. <td>Size
baa0: 20 6f 66 20 61 20 64 69 73 6b 20 73 65 63 74 6f of a disk secto
bab0: 72 20 61 73 73 75 6d 65 64 20 62 79 20 74 68 65 r assumed by the
bac0: 20 70 72 6f 63 65 73 73 20 74 68 61 74 20 77 72 process that wr
bad0: 6f 74 65 20 74 68 69 73 0a 20 20 20 20 20 20 20 ote this.
bae0: 20 6a 6f 75 72 6e 61 6c 2e 0a 3c 74 72 3e 3c 74 journal..<tr><t
baf0: 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 d valign=top ali
bb00: 67 6e 3d 63 65 6e 74 65 72 3e 32 34 0a 20 20 20 gn=center>24.
bb10: 20 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 <td valign=top
bb20: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 0a 20 align=center>4.
bb30: 20 20 20 3c 74 64 3e 53 69 7a 65 20 6f 66 20 70 <td>Size of p
bb40: 61 67 65 73 20 69 6e 20 74 68 69 73 20 6a 6f 75 ages in this jou
bb50: 72 6e 61 6c 2e 0a 3c 2f 74 61 62 6c 65 3e 0a 3c rnal..</table>.<
bb60: 2f 63 65 6e 74 65 72 3e 0a 0a 3c 70 3e 41 20 72 /center>..<p>A r
bb70: 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 ollback journal
bb80: 68 65 61 64 65 72 20 69 73 20 70 61 64 64 65 64 header is padded
bb90: 20 77 69 74 68 20 7a 65 72 6f 73 20 6f 75 74 20 with zeros out
bba0: 74 6f 20 74 68 65 20 73 69 7a 65 20 6f 66 20 61 to the size of a
bbb0: 20 0a 73 69 6e 67 6c 65 20 73 65 63 74 6f 72 20 .single sector
bbc0: 28 61 73 20 64 65 66 69 6e 65 64 20 62 79 20 74 (as defined by t
bbd0: 68 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 69 he sector size i
bbe0: 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 nteger at offset
bbf0: 20 32 30 29 2e 0a 54 68 65 20 68 65 61 64 65 72 20)..The header
bc00: 20 69 73 20 69 6e 20 61 20 73 65 63 74 6f 72 20 is in a sector
bc10: 62 79 20 69 74 73 65 6c 66 20 73 6f 20 74 68 61 by itself so tha
bc20: 74 20 69 66 20 61 20 70 6f 77 65 72 20 6c 6f 73 t if a power los
bc30: 73 20 6f 63 63 75 72 73 20 77 68 69 6c 65 0a 77 s occurs while.w
bc40: 72 69 74 69 6e 67 20 74 68 65 20 73 65 63 74 6f riting the secto
bc50: 72 2c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 r, information t
bc60: 68 61 74 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20 hat follows the
bc70: 68 65 61 64 65 72 20 77 69 6c 6c 20 62 65 0a 28 header will be.(
bc80: 68 6f 70 65 66 75 6c 6c 79 29 20 75 6e 64 61 6d hopefully) undam
bc90: 61 67 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 66 aged.</p>..<p>Af
bca0: 74 65 72 20 74 68 65 20 68 65 61 64 65 72 20 61 ter the header a
bcb0: 6e 64 20 7a 65 72 6f 20 70 61 64 64 69 6e 67 20 nd zero padding
bcc0: 61 72 65 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 are zero or more
bcd0: 20 70 61 67 65 20 72 65 63 6f 72 64 73 2e 20 20 page records.
bce0: 45 61 63 68 0a 70 61 67 65 20 72 65 63 6f 72 64 Each.page record
bcf0: 20 73 74 6f 72 65 73 20 61 20 63 6f 70 79 20 6f stores a copy o
bd00: 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 f the content of
bd10: 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 a page from the
bd20: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 62 database file.b
bd30: 65 66 6f 72 65 20 69 74 20 77 61 73 20 63 68 61 efore it was cha
bd40: 6e 67 65 64 2e 20 20 54 68 65 20 73 61 6d 65 20 nged. The same
bd50: 70 61 67 65 20 6d 61 79 20 6e 6f 74 20 61 70 70 page may not app
bd60: 65 61 72 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e ear more than on
bd70: 63 65 0a 77 69 74 68 69 6e 20 61 20 73 69 6e 67 ce.within a sing
bd80: 6c 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 le rollback jour
bd90: 6e 61 6c 2e 0a 54 6f 20 72 6f 6c 6c 62 61 63 6b nal..To rollback
bda0: 20 61 6e 20 69 6e 63 6f 6d 70 6c 65 74 65 20 74 an incomplete t
bdb0: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 20 70 72 ransaction, a pr
bdc0: 6f 63 65 73 73 0a 68 61 73 20 6d 65 72 65 6c 79 ocess.has merely
bdd0: 20 74 6f 20 72 65 61 64 20 74 68 65 20 72 6f 6c to read the rol
bde0: 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 72 lback journal fr
bdf0: 6f 6d 20 62 65 67 69 6e 6e 69 6e 67 20 74 6f 20 om beginning to
be00: 65 6e 64 20 61 6e 64 0a 77 72 69 74 65 20 70 61 end and.write pa
be10: 67 65 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 ges found in the
be20: 20 6a 6f 75 72 6e 61 6c 20 62 61 63 6b 20 69 6e journal back in
be30: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
be40: 66 69 6c 65 20 61 74 20 74 68 65 0a 61 70 70 72 file at the.appr
be50: 6f 70 72 69 61 74 65 20 6c 6f 63 61 74 69 6f 6e opriate location
be60: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4c 65 74 20 74 68 .</p>..<p>Let th
be70: 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 e database page
be80: 73 69 7a 65 20 28 74 68 65 20 76 61 6c 75 65 20 size (the value
be90: 6f 66 20 74 68 65 20 69 6e 74 65 67 65 72 20 61 of the integer a
bea0: 74 20 6f 66 66 73 65 74 20 32 34 20 0a 69 6e 20 t offset 24 .in
beb0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 the journal head
bec0: 65 72 29 20 62 65 20 4e 2e 0a 54 68 65 6e 20 74 er) be N..Then t
bed0: 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 61 20 70 he format of a p
bee0: 61 67 65 20 72 65 63 6f 72 64 20 69 73 20 61 73 age record is as
bef0: 20 66 6f 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 0a 3c follows:</p>..<
bf00: 63 65 6e 74 65 72 3e 0a 3c 69 3e 52 6f 6c 6c 62 center>.<i>Rollb
bf10: 61 63 6b 20 4a 6f 75 72 6e 61 6c 20 50 61 67 65 ack Journal Page
bf20: 20 52 65 63 6f 72 64 20 46 6f 72 6d 61 74 3c 2f Record Format</
bf30: 69 3e 3c 62 72 3e 0a 3c 74 61 62 6c 65 20 77 69 i><br>.<table wi
bf40: 64 74 68 3d 22 38 30 25 22 20 62 6f 72 64 65 72 dth="80%" border
bf50: 3d 31 3e 0a 3c 74 72 3e 3c 74 68 3e 4f 66 66 73 =1>.<tr><th>Offs
bf60: 65 74 3c 74 68 3e 53 69 7a 65 3c 74 68 3e 44 65 et<th>Size<th>De
bf70: 73 63 72 69 70 74 69 6f 6e 0a 3c 74 72 3e 3c 74 scription.<tr><t
bf80: 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 d valign=top ali
bf90: 67 6e 3d 63 65 6e 74 65 72 3e 30 0a 20 20 20 20 gn=center>0.
bfa0: 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 <td valign=top a
bfb0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 0a 20 20 lign=center>4.
bfc0: 20 20 3c 74 64 3e 54 68 65 20 70 61 67 65 20 6e <td>The page n
bfd0: 75 6d 62 65 72 20 69 6e 20 74 68 65 20 64 61 74 umber in the dat
bfe0: 61 62 61 73 65 20 66 69 6c 65 0a 3c 74 72 3e 3c abase file.<tr><
bff0: 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c td valign=top al
c000: 69 67 6e 3d 63 65 6e 74 65 72 3e 34 0a 20 20 20 ign=center>4.
c010: 20 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 <td valign=top
c020: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 4e 0a 20 align=center>N.
c030: 20 20 20 3c 74 64 3e 4f 72 69 67 69 6e 61 6c 20 <td>Original
c040: 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 content of the p
c050: 61 67 65 20 70 72 69 6f 72 20 74 6f 20 74 68 65 age prior to the
c060: 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 74 72 start of the tr
c070: 61 6e 73 61 63 74 69 6f 6e 0a 3c 74 72 3e 3c 74 ansaction.<tr><t
c080: 64 20 76 61 6c 69 67 6e 3d 74 6f 70 20 61 6c 69 d valign=top ali
c090: 67 6e 3d 63 65 6e 74 65 72 3e 4e 2b 34 0a 20 20 gn=center>N+4.
c0a0: 20 20 3c 74 64 20 76 61 6c 69 67 6e 3d 74 6f 70 <td valign=top
c0b0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 34 0a align=center>4.
c0c0: 20 20 20 20 3c 74 64 3e 43 68 65 63 6b 73 75 6d <td>Checksum
c0d0: 0a 3c 2f 74 61 62 6c 65 3e 0a 3c 2f 63 65 6e 74 .</table>.</cent
c0e0: 65 72 3e 0a 0a 0a 3c 70 3e 54 68 65 20 63 68 65 er>...<p>The che
c0f0: 63 6b 73 75 6d 20 69 73 20 61 6e 20 75 6e 73 69 cksum is an unsi
c100: 67 6e 65 64 20 33 32 2d 62 69 74 20 69 6e 74 65 gned 32-bit inte
c110: 67 65 72 20 63 6f 6d 70 75 74 65 64 20 61 73 20 ger computed as
c120: 66 6f 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 0a 3c 6f follows:</p>..<o
c130: 6c 3e 0a 3c 6c 69 3e 49 6e 69 74 69 61 6c 69 7a l>.<li>Initializ
c140: 65 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 74 e the checksum t
c150: 6f 20 74 68 65 20 63 68 65 63 6b 73 75 6d 20 6e o the checksum n
c160: 6f 6e 63 65 20 76 61 6c 75 65 20 66 6f 75 6e 64 once value found
c170: 20 69 6e 20 74 68 65 0a 6a 6f 75 72 6e 61 6c 20 in the.journal
c180: 68 65 61 64 65 72 20 61 74 20 6f 66 66 73 65 74 header at offset
c190: 20 31 32 2e 0a 3c 6c 69 3e 49 6e 69 74 69 61 6c 12..<li>Initial
c1a0: 69 7a 65 20 69 6e 64 65 78 20 58 20 74 6f 20 62 ize index X to b
c1b0: 65 20 4e 2d 32 30 30 20 28 77 68 65 72 65 20 4e e N-200 (where N
c1c0: 20 69 73 20 74 68 65 20 73 69 7a 65 20 6f 66 20 is the size of
c1d0: 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 0a a database page.
c1e0: 69 6e 20 62 79 74 65 73 2e 0a 3c 6c 69 3e 49 6e in bytes..<li>In
c1f0: 74 65 72 70 72 65 74 20 74 68 65 20 66 6f 75 72 terpret the four
c200: 20 62 79 74 65 73 20 61 74 20 6f 66 66 73 65 74 bytes at offset
c210: 20 58 20 69 6e 74 6f 20 74 68 65 20 70 61 67 65 X into the page
c220: 20 61 73 20 61 20 34 2d 62 79 74 65 20 62 69 67 as a 4-byte big
c230: 2d 65 6e 64 69 61 6e 0a 75 6e 73 69 67 6e 65 64 -endian.unsigned
c240: 20 69 6e 74 65 67 65 72 2e 20 20 41 64 64 20 74 integer. Add t
c250: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 61 74 he value of that
c260: 20 69 6e 74 65 67 65 72 20 74 6f 20 74 68 65 20 integer to the
c270: 63 68 65 63 6b 73 75 6d 2e 0a 3c 6c 69 3e 53 75 checksum..<li>Su
c280: 62 74 72 61 63 65 20 32 30 30 20 66 72 6f 6d 20 btrace 200 from
c290: 58 2e 0a 3c 6c 69 3e 49 66 20 58 20 69 73 20 67 X..<li>If X is g
c2a0: 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 reater than or e
c2b0: 71 75 61 6c 20 74 6f 20 7a 65 72 6f 2c 20 67 6f qual to zero, go
c2c0: 20 62 61 63 6b 20 74 6f 20 73 74 65 70 20 33 2e back to step 3.
c2d0: 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54 68 65 20 63 .</ol>..<p>The c
c2e0: 68 65 63 6b 73 75 6d 20 76 61 6c 75 65 20 69 73 hecksum value is
c2f0: 20 75 73 65 64 20 74 6f 20 67 75 61 72 64 20 61 used to guard a
c300: 67 61 69 6e 73 74 20 69 6e 63 6f 6d 70 6c 65 74 gainst incomplet
c310: 65 20 77 72 69 74 65 73 20 6f 66 0a 61 20 6a 6f e writes of.a jo
c320: 75 72 6e 61 6c 20 70 61 67 65 20 72 65 63 6f 72 urnal page recor
c330: 64 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 70 6f d following a po
c340: 77 65 72 20 66 61 69 6c 75 72 65 2e 20 20 41 20 wer failure. A
c350: 64 69 66 66 65 72 65 6e 74 20 72 61 6e 64 6f 6d different random
c360: 20 6e 6f 6e 63 65 0a 69 73 20 75 73 65 64 20 65 nonce.is used e
c370: 61 63 68 20 74 69 6d 65 20 61 20 74 72 61 73 61 ach time a trasa
c380: 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64 ction is started
c390: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6d 69 6e in order to min
c3a0: 69 6d 69 7a 65 20 74 68 65 20 72 69 73 6b 0a 74 imize the risk.t
c3b0: 68 61 74 20 75 6e 77 72 69 74 74 65 6e 20 73 65 hat unwritten se
c3c0: 63 74 6f 72 73 20 6d 69 67 68 74 20 62 79 20 63 ctors might by c
c3d0: 68 61 6e 63 65 20 63 6f 6e 74 61 69 6e 20 64 61 hance contain da
c3e0: 74 61 20 66 72 6f 6d 20 74 68 65 20 73 61 6d 65 ta from the same
c3f0: 20 70 61 67 65 0a 74 68 61 74 20 77 61 73 20 61 page.that was a
c400: 20 70 61 72 74 20 6f 66 20 70 72 69 6f 72 20 6a part of prior j
c410: 6f 75 72 6e 61 6c 73 2e 20 20 42 79 20 63 68 61 ournals. By cha
c420: 6e 67 69 6e 67 20 74 68 65 20 6e 6f 6e 63 65 20 nging the nonce
c430: 66 6f 72 20 65 61 63 68 0a 74 72 61 6e 73 61 63 for each.transac
c440: 74 69 6f 6e 2c 20 73 74 61 6c 65 20 64 61 74 61 tion, stale data
c450: 20 6f 6e 20 64 69 73 6b 20 77 69 6c 6c 20 73 74 on disk will st
c460: 69 6c 6c 20 67 65 6e 65 72 61 74 65 20 61 6e 20 ill generate an
c470: 69 6e 63 6f 72 72 65 63 74 20 63 68 65 63 6b 73 incorrect checks
c480: 75 6d 0a 61 6e 64 20 62 65 20 64 65 74 65 63 74 um.and be detect
c490: 65 64 20 77 69 74 68 20 68 69 67 68 20 70 72 6f ed with high pro
c4a0: 62 61 62 69 6c 69 74 79 2e 20 20 54 68 65 20 63 bability. The c
c4b0: 68 65 63 6b 73 75 6d 20 6f 6e 6c 79 20 75 73 65 hecksum only use
c4c0: 73 20 61 20 73 70 61 72 63 65 20 73 61 6d 70 6c s a sparce sampl
c4d0: 65 0a 6f 66 20 33 32 2d 62 69 74 20 77 6f 72 64 e.of 32-bit word
c4e0: 73 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 20 s from the data
c4f0: 72 65 63 6f 72 64 20 66 6f 72 20 70 65 72 66 6f record for perfo
c500: 72 6d 61 6e 63 65 20 72 65 61 73 6f 6e 73 20 2d rmance reasons -
c510: 20 64 65 73 69 67 6e 20 73 74 75 64 69 65 73 20 design studies
c520: 0a 64 75 72 69 6e 67 20 74 68 65 20 70 6c 61 6e .during the plan
c530: 6e 69 6e 67 20 70 68 61 73 65 73 20 6f 66 20 53 ning phases of S
c540: 51 4c 69 74 65 20 33 2e 30 2e 30 20 73 68 6f 77 QLite 3.0.0 show
c550: 65 64 0a 61 20 73 69 67 6e 69 66 69 63 61 6e 74 ed.a significant
c560: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 68 69 74 performance hit
c570: 20 69 6e 20 63 68 65 63 6b 73 75 6d 6d 69 6e 67 in checksumming
c580: 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 67 65 the entire page
c590: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4c 65 74 20 74 68 .</p>..<p>Let th
c5a0: 65 20 70 61 67 65 20 63 6f 75 6e 74 20 76 61 6c e page count val
c5b0: 75 65 20 61 74 20 6f 66 66 73 65 74 20 38 20 69 ue at offset 8 i
c5c0: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 n the journal he
c5d0: 61 64 65 72 20 62 79 20 4d 2e 0a 49 66 20 4d 20 ader by M..If M
c5e0: 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 is greater than
c5f0: 7a 65 72 6f 20 74 68 65 6e 20 61 66 74 65 72 20 zero then after
c600: 4d 20 70 61 67 65 20 72 65 63 6f 72 64 73 20 74 M page records t
c610: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a he journal file.
c620: 6d 61 79 20 62 65 20 7a 65 72 6f 20 70 61 64 64 may be zero padd
c630: 65 64 20 6f 75 74 20 74 6f 20 74 68 65 20 6e 65 ed out to the ne
c640: 78 74 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 74 xt multiple of t
c650: 68 65 20 73 65 63 74 6f 72 20 73 69 7a 65 20 61 he sector size a
c660: 6e 64 20 61 6e 6f 74 68 65 72 0a 6a 6f 75 72 6e nd another.journ
c670: 61 6c 20 68 65 61 64 65 72 20 6d 61 79 20 62 65 al header may be
c680: 20 69 6e 73 65 72 74 65 64 2e 20 20 41 6c 6c 20 inserted. All
c690: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 73 20 journal headers
c6a0: 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65 0a within the same.
c6b0: 6a 6f 75 72 6e 61 6c 20 6d 75 73 74 20 63 6f 6e journal must con
c6c0: 74 61 69 6e 20 74 68 65 20 73 61 6d 65 20 64 61 tain the same da
c6d0: 74 61 62 61 73 65 20 70 61 67 65 20 73 69 7a 65 tabase page size
c6e0: 20 61 6e 64 20 73 65 63 74 6f 72 20 73 69 7a 65 and sector size
c6f0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 4d 20 69 .</p>..<p>If M i
c700: 73 20 2d 31 20 69 6e 20 74 68 65 20 69 6e 69 74 s -1 in the init
c710: 69 61 6c 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 ial journal head
c720: 65 72 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d er, then the num
c730: 62 65 72 20 6f 66 20 70 61 67 65 20 72 65 63 6f ber of page reco
c740: 72 64 73 0a 74 68 61 74 20 66 6f 6c 6c 6f 77 20 rds.that follow
c750: 69 73 20 63 6f 6d 70 75 74 65 64 20 62 79 20 66 is computed by f
c760: 69 67 75 72 65 20 6f 75 74 20 68 6f 77 20 6d 61 igure out how ma
c770: 6e 79 20 70 61 67 65 20 72 65 63 6f 72 64 73 20 ny page records
c780: 77 69 6c 6c 20 66 69 74 20 69 6e 0a 74 68 65 20 will fit in.the
c790: 61 76 61 69 6c 61 62 6c 65 20 73 70 61 63 65 20 available space
c7a0: 6f 66 20 74 68 65 20 72 65 6d 61 69 6e 64 65 72 of the remainder
c7b0: 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 of the journal
c7c0: 66 69 6c 65 2e 3c 2f 70 3e 0a file.</p>.