Documentation Source Text

Hex Artifact Content
Login

Artifact eeec6d2205a4877789e69ae7a9dc40802183274a:


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  >&nbsp;.    <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>&#x2714;
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  >&nbsp;.    <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>&#x2714;
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>&#x2714;.  
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>&#x2714;.  
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>&#x2
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>&#x2714;.  
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>&nbsp;.    
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  &#x2714;.    <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>&nbsp;.
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  &#x2714;.    <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>&#x2714
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>&#x2
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>&nbsp;.    
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>&#x2
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>&#x2714;.  
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  >&nbsp;<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&#x2265;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>.