/ Hex Artifact Content
Login

Artifact 890248cf7b70e60c383b0e84d77d5132b3ead42b:


0000: 23 21 2f 75 73 72 2f 62 69 6e 2f 74 63 6c 73 68  #!/usr/bin/tclsh
0010: 0a 73 6f 75 72 63 65 20 63 6f 6d 6d 6f 6e 2e 74  .source common.t
0020: 63 6c 0a 68 65 61 64 65 72 20 7b 53 51 4c 69 74  cl.header {SQLit
0030: 65 20 56 65 72 73 69 6f 6e 20 33 20 4f 76 65 72  e Version 3 Over
0040: 76 69 65 77 7d 0a 70 75 74 73 20 7b 0a 3c 68 32  view}.puts {.<h2
0050: 3e 53 51 4c 69 74 65 20 56 65 72 73 69 6f 6e 20  >SQLite Version 
0060: 33 20 4f 76 65 72 76 69 65 77 3c 2f 68 32 3e 0a  3 Overview</h2>.
0070: 0a 3c 70 3e 0a 53 51 4c 69 74 65 20 76 65 72 73  .<p>.SQLite vers
0080: 69 6f 6e 20 33 2e 30 20 69 6e 74 72 6f 64 75 63  ion 3.0 introduc
0090: 65 73 20 69 6d 70 6f 72 74 61 6e 74 20 63 68 61  es important cha
00a0: 6e 67 65 73 20 74 6f 20 74 68 65 20 6c 69 62 72  nges to the libr
00b0: 61 72 79 2c 20 69 6e 63 6c 75 64 69 6e 67 3a 0a  ary, including:.
00c0: 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 41  </p>..<ul>.<li>A
00d0: 20 6d 6f 72 65 20 63 6f 6d 70 61 63 74 20 66 6f   more compact fo
00e0: 72 6d 61 74 20 66 6f 72 20 64 61 74 61 62 61 73  rmat for databas
00f0: 65 20 66 69 6c 65 73 2e 3c 2f 6c 69 3e 0a 3c 6c  e files.</li>.<l
0100: 69 3e 4d 61 6e 69 66 65 73 74 20 74 79 70 69 6e  i>Manifest typin
0110: 67 20 61 6e 64 20 42 4c 4f 42 20 73 75 70 70 6f  g and BLOB suppo
0120: 72 74 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 53 75 70  rt.</li>.<li>Sup
0130: 70 6f 72 74 20 66 6f 72 20 62 6f 74 68 20 55 54  port for both UT
0140: 46 2d 38 20 61 6e 64 20 55 54 46 2d 31 36 20 74  F-8 and UTF-16 t
0150: 65 78 74 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73  ext.</li>.<li>Us
0160: 65 72 2d 64 65 66 69 6e 65 64 20 74 65 78 74 20  er-defined text 
0170: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e  collating sequen
0180: 63 65 73 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 36 34  ces.</li>.<li>64
0190: 2d 62 69 74 20 52 4f 57 49 44 73 2e 3c 2f 6c 69  -bit ROWIDs.</li
01a0: 3e 0a 3c 6c 69 3e 49 6d 70 72 6f 76 65 64 20 43  >.<li>Improved C
01b0: 6f 6e 63 75 72 72 65 6e 63 79 2e 3c 2f 6c 69 3e  oncurrency.</li>
01c0: 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 0a 54 68 69 73  .</ul>..<p>.This
01d0: 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 61 20 71   document is a q
01e0: 75 69 63 6b 20 69 6e 74 72 6f 64 75 63 74 69 6f  uick introductio
01f0: 6e 20 74 6f 20 74 68 65 20 63 68 61 6e 67 65 73  n to the changes
0200: 20 66 6f 72 20 53 51 4c 69 74 65 20 33 2e 30 0a   for SQLite 3.0.
0210: 66 6f 72 20 75 73 65 72 73 20 77 68 6f 20 61 72  for users who ar
0220: 65 20 61 6c 72 65 61 64 79 20 66 61 6d 69 6c 69  e already famili
0230: 61 72 20 77 69 74 68 20 53 51 4c 69 74 65 20 76  ar with SQLite v
0240: 65 72 73 69 6f 6e 20 32 2e 38 2e 0a 3c 2f 70 3e  ersion 2.8..</p>
0250: 0a 0a 3c 68 33 3e 4e 61 6d 69 6e 67 20 43 68 61  ..<h3>Naming Cha
0260: 6e 67 65 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 53  nges</h3>..<p>.S
0270: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 32 2e  QLite version 2.
0280: 38 20 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20  8 will continue 
0290: 74 6f 20 62 65 20 73 75 70 70 6f 72 74 65 64 20  to be supported 
02a0: 77 69 74 68 20 62 75 67 20 66 69 78 65 73 0a 66  with bug fixes.f
02b0: 6f 72 20 74 68 65 20 66 6f 72 65 73 65 65 61 62  or the foreseeab
02c0: 6c 65 20 66 75 74 75 72 65 2e 20 20 49 6e 20 6f  le future.  In o
02d0: 72 64 65 72 20 74 6f 20 61 6c 6c 6f 77 20 53 51  rder to allow SQ
02e0: 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 38  Lite version 2.8
02f0: 0a 61 6e 64 20 53 51 4c 69 74 65 20 76 65 72 73  .and SQLite vers
0300: 69 6f 6e 20 33 2e 30 20 74 6f 20 70 65 61 63 65  ion 3.0 to peace
0310: 66 75 6c 6c 79 20 63 6f 65 78 69 73 74 2c 20 74  fully coexist, t
0320: 68 65 20 6e 61 6d 65 73 20 6f 66 20 6b 65 79 20  he names of key 
0330: 66 69 6c 65 73 0a 61 6e 64 20 41 50 49 73 20 69  files.and APIs i
0340: 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  n SQLite version
0350: 20 33 2e 30 20 68 61 76 65 20 62 65 65 6e 20 63   3.0 have been c
0360: 68 61 6e 67 65 64 20 74 6f 20 69 6e 63 6c 75 64  hanged to includ
0370: 65 20 74 68 65 0a 63 68 61 72 61 63 74 65 72 20  e the.character 
0380: 22 33 22 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c  "3".  For exampl
0390: 65 2c 20 74 68 65 20 69 6e 63 6c 75 64 65 20 66  e, the include f
03a0: 69 6c 65 20 75 73 65 64 20 62 79 20 43 20 70 72  ile used by C pr
03b0: 6f 67 72 61 6d 73 0a 68 61 73 20 62 65 65 6e 20  ograms.has been 
03c0: 63 68 61 6e 67 65 64 20 66 72 6f 6d 20 22 73 71  changed from "sq
03d0: 6c 69 74 65 2e 68 22 20 74 6f 20 22 73 71 6c 69  lite.h" to "sqli
03e0: 74 65 33 2e 68 22 2e 20 20 41 6e 64 20 74 68 65  te3.h".  And the
03f0: 20 6e 61 6d 65 20 6f 66 0a 74 68 65 20 73 68 65   name of.the she
0400: 6c 6c 20 70 72 6f 67 72 61 6d 20 75 73 65 64 20  ll program used 
0410: 74 6f 20 69 6e 74 65 72 61 63 74 20 77 69 74 68  to interact with
0420: 20 64 61 74 61 62 61 73 65 73 20 68 61 73 20 62   databases has b
0430: 65 65 6e 20 63 68 61 6e 67 65 64 0a 66 72 6f 6d  een changed.from
0440: 20 22 73 71 6c 69 74 65 2e 65 78 65 22 20 74 6f   "sqlite.exe" to
0450: 20 22 73 71 6c 69 74 65 33 2e 65 78 65 22 2e 20   "sqlite3.exe". 
0460: 20 57 69 74 68 20 74 68 65 73 65 20 63 68 61 6e   With these chan
0470: 67 65 73 2c 20 69 74 20 69 73 20 70 6f 73 73 69  ges, it is possi
0480: 62 6c 65 0a 74 6f 20 68 61 76 65 20 62 6f 74 68  ble.to have both
0490: 20 53 51 4c 69 74 65 20 32 2e 38 20 61 6e 64 20   SQLite 2.8 and 
04a0: 53 51 4c 69 74 65 20 33 2e 30 20 69 6e 73 74 61  SQLite 3.0 insta
04b0: 6c 6c 65 64 20 6f 6e 20 74 68 65 20 73 61 6d 65  lled on the same
04c0: 20 73 79 73 74 65 6d 20 61 74 0a 74 68 65 20 73   system at.the s
04d0: 61 6d 65 20 74 69 6d 65 2e 20 20 41 6e 64 20 69  ame time.  And i
04e0: 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 66 6f  t is possible fo
04f0: 72 20 74 68 65 20 73 61 6d 65 20 43 20 70 72 6f  r the same C pro
0500: 67 72 61 6d 20 74 6f 20 6c 69 6e 6b 0a 61 67 61  gram to link.aga
0510: 69 6e 73 74 20 62 6f 74 68 20 53 51 4c 69 74 65  inst both SQLite
0520: 20 32 2e 38 20 61 6e 64 20 53 51 4c 69 74 65 20   2.8 and SQLite 
0530: 33 2e 30 20 61 74 20 74 68 65 20 73 61 6d 65 20  3.0 at the same 
0540: 74 69 6d 65 20 61 6e 64 20 74 6f 20 75 73 65 0a  time and to use.
0550: 62 6f 74 68 20 6c 69 62 72 61 72 69 65 73 20 61  both libraries a
0560: 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e  t the same time.
0570: 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e 4e 65 77 20 46  .</p>..<h3>New F
0580: 69 6c 65 20 46 6f 72 6d 61 74 3c 2f 68 33 3e 0a  ile Format</h3>.
0590: 0a 3c 70 3e 0a 54 68 65 20 66 6f 72 6d 61 74 20  .<p>.The format 
05a0: 75 73 65 64 20 62 79 20 53 51 4c 69 74 65 20 64  used by SQLite d
05b0: 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 68 61  atabase files ha
05c0: 73 20 62 65 65 6e 20 63 6f 6d 70 6c 65 74 65 6c  s been completel
05d0: 79 20 72 65 76 69 73 65 64 2e 0a 54 68 65 20 6f  y revised..The o
05e0: 6c 64 20 76 65 72 73 69 6f 6e 20 32 2e 31 20 66  ld version 2.1 f
05f0: 6f 72 6d 61 74 20 61 6e 64 20 74 68 65 20 6e 65  ormat and the ne
0600: 77 20 33 2e 30 20 66 6f 72 6d 61 74 20 61 72 65  w 3.0 format are
0610: 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 77 69   incompatible wi
0620: 74 68 0a 6f 6e 65 20 61 6e 6f 74 68 65 72 2e 20  th.one another. 
0630: 20 56 65 72 73 69 6f 6e 20 32 2e 38 20 6f 66 20   Version 2.8 of 
0640: 53 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f 74 20  SQLite will not 
0650: 72 65 61 64 20 61 20 76 65 72 73 69 6f 6e 20 33  read a version 3
0660: 2e 30 20 64 61 74 61 62 61 73 65 0a 66 69 6c 65  .0 database.file
0670: 73 20 61 6e 64 20 76 65 72 73 69 6f 6e 20 33 2e  s and version 3.
0680: 30 20 6f 66 20 53 51 4c 69 74 65 20 77 69 6c 6c  0 of SQLite will
0690: 20 6e 6f 74 20 72 65 61 64 20 61 20 76 65 72 73   not read a vers
06a0: 69 6f 6e 20 32 2e 38 20 64 61 74 61 62 61 73 65  ion 2.8 database
06b0: 20 66 69 6c 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e   file..</p>..<p>
06c0: 0a 54 6f 20 63 6f 6e 76 65 72 74 20 61 6e 20 53  .To convert an S
06d0: 51 4c 69 74 65 20 32 2e 38 20 64 61 74 61 62 61  QLite 2.8 databa
06e0: 73 65 20 69 6e 74 6f 20 61 6e 20 53 51 4c 69 74  se into an SQLit
06f0: 65 20 33 2e 30 20 64 61 74 61 62 61 73 65 2c 20  e 3.0 database, 
0700: 68 61 76 65 0a 72 65 61 64 79 20 74 68 65 20 63  have.ready the c
0710: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 68 65 6c  ommand-line shel
0720: 6c 73 20 66 6f 72 20 62 6f 74 68 20 76 65 72 73  ls for both vers
0730: 69 6f 6e 20 32 2e 38 20 61 6e 64 20 33 2e 30 2e  ion 2.8 and 3.0.
0740: 20 20 54 68 65 6e 0a 65 6e 74 65 72 20 61 20 63    Then.enter a c
0750: 6f 6d 6d 61 6e 64 20 6c 69 6b 65 20 74 68 65 20  ommand like the 
0760: 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 3c 2f 70 3e 0a  following:.</p>.
0770: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
0780: 65 3e 0a 73 71 6c 69 74 65 20 4f 4c 44 2e 44 42  e>.sqlite OLD.DB
0790: 20 2e 64 75 6d 70 20 7c 20 73 71 6c 69 74 65 33   .dump | sqlite3
07a0: 20 4e 45 57 2e 44 42 0a 3c 2f 70 72 65 3e 3c 2f   NEW.DB.</pre></
07b0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e  blockquote>..<p>
07c0: 0a 54 68 65 20 6e 65 77 20 64 61 74 61 62 61 73  .The new databas
07d0: 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 75 73  e file format us
07e0: 65 73 20 42 2b 74 72 65 65 73 20 66 6f 72 20 74  es B+trees for t
07f0: 61 62 6c 65 73 2e 20 20 49 6e 20 61 20 42 2b 74  ables.  In a B+t
0800: 72 65 65 2c 20 61 6c 6c 0a 64 61 74 61 20 69 73  ree, all.data is
0810: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 6c   stored in the l
0820: 65 61 76 65 73 20 6f 66 20 74 68 65 20 74 72 65  eaves of the tre
0830: 65 20 69 6e 73 74 65 61 64 20 6f 66 20 69 6e 20  e instead of in 
0840: 62 6f 74 68 20 74 68 65 20 6c 65 61 76 65 73 20  both the leaves 
0850: 61 6e 64 0a 74 68 65 20 69 6e 74 65 72 6d 65 64  and.the intermed
0860: 69 61 74 65 20 62 72 61 6e 63 68 20 6e 6f 64 65  iate branch node
0870: 73 2e 20 20 54 68 65 20 75 73 65 20 6f 66 20 42  s.  The use of B
0880: 2b 74 72 65 65 73 20 66 6f 72 20 74 61 62 6c 65  +trees for table
0890: 73 20 61 6c 6c 6f 77 73 20 66 6f 72 0a 62 65 74  s allows for.bet
08a0: 74 65 72 20 73 63 61 6c 61 62 69 6c 69 74 79 20  ter scalability 
08b0: 61 6e 64 20 74 68 65 20 73 74 6f 72 61 67 65 20  and the storage 
08c0: 6f 66 20 6c 61 72 67 65 72 20 64 61 74 61 20 66  of larger data f
08d0: 69 65 6c 64 73 20 77 69 74 68 6f 75 74 20 74 68  ields without th
08e0: 65 20 75 73 65 20 6f 66 0a 6f 76 65 72 66 6c 6f  e use of.overflo
08f0: 77 20 70 61 67 65 73 2e 20 20 54 72 61 64 69 74  w pages.  Tradit
0900: 69 6f 6e 61 6c 20 42 2d 74 72 65 65 73 20 61 72  ional B-trees ar
0910: 65 20 73 74 69 6c 6c 20 75 73 65 64 20 66 6f 72  e still used for
0920: 20 69 6e 64 69 63 65 73 2e 3c 2f 70 3e 0a 0a 3c   indices.</p>..<
0930: 70 3e 0a 54 68 65 20 6e 65 77 20 66 69 6c 65 20  p>.The new file 
0940: 66 6f 72 6d 61 74 20 61 6c 73 6f 20 73 75 70 70  format also supp
0950: 6f 72 74 73 20 76 61 72 69 61 62 6c 65 20 70 61  orts variable pa
0960: 67 65 73 20 73 69 7a 65 73 20 62 65 74 77 65 65  ges sizes betwee
0970: 6e 20 35 31 32 20 61 6e 64 0a 33 32 37 36 38 20  n 512 and.32768 
0980: 62 79 74 65 73 2e 20 20 54 68 65 20 73 69 7a 65  bytes.  The size
0990: 20 6f 66 20 61 20 70 61 67 65 20 69 73 20 73 74   of a page is st
09a0: 6f 72 65 64 20 69 6e 20 74 68 65 20 66 69 6c 65  ored in the file
09b0: 20 68 65 61 64 65 72 20 73 6f 20 74 68 65 0a 73   header so the.s
09c0: 61 6d 65 20 6c 69 62 72 61 72 79 20 63 61 6e 20  ame library can 
09d0: 72 65 61 64 20 64 61 74 61 62 61 73 65 73 20 77  read databases w
09e0: 69 74 68 20 64 69 66 66 65 72 65 6e 74 20 70 61  ith different pa
09f0: 67 65 73 20 73 69 7a 65 73 2c 20 69 6e 20 74 68  ges sizes, in th
0a00: 65 6f 72 79 2c 0a 74 68 6f 75 67 68 20 74 68 69  eory,.though thi
0a10: 73 20 66 65 61 74 75 72 65 20 68 61 73 20 6e 6f  s feature has no
0a20: 74 20 79 65 74 20 62 65 65 6e 20 69 6d 70 6c 65  t yet been imple
0a30: 6d 65 6e 74 65 64 20 69 6e 20 70 72 61 63 74 69  mented in practi
0a40: 63 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68  ce..</p>..<p>.Th
0a50: 65 20 6e 65 77 20 66 69 6c 65 20 66 6f 72 6d 61  e new file forma
0a60: 74 20 6f 6d 69 74 73 20 75 6e 75 73 65 64 20 66  t omits unused f
0a70: 69 65 6c 64 73 20 66 72 6f 6d 20 69 74 73 20 64  ields from its d
0a80: 69 73 6b 20 69 6d 61 67 65 73 2e 20 20 46 6f 72  isk images.  For
0a90: 20 65 78 61 6d 70 6c 65 2c 0a 69 6e 64 69 63 65   example,.indice
0aa0: 73 20 75 73 65 20 6f 6e 6c 79 20 74 68 65 20 6b  s use only the k
0ab0: 65 79 20 70 61 72 74 20 6f 66 20 61 20 42 2d 74  ey part of a B-t
0ac0: 72 65 65 20 72 65 63 6f 72 64 20 61 6e 64 20 6e  ree record and n
0ad0: 6f 74 20 74 68 65 20 64 61 74 61 2e 20 20 53 6f  ot the data.  So
0ae0: 0a 66 6f 72 20 69 6e 64 69 63 65 73 2c 20 74 68  .for indices, th
0af0: 65 20 66 69 65 6c 64 20 74 68 61 74 20 72 65 63  e field that rec
0b00: 6f 72 64 73 20 74 68 65 20 6c 65 6e 67 74 68 20  ords the length 
0b10: 6f 66 20 74 68 65 20 64 61 74 61 20 69 73 20 6f  of the data is o
0b20: 6d 69 74 74 65 64 2e 0a 49 6e 74 65 67 65 72 20  mitted..Integer 
0b30: 76 61 6c 75 65 73 20 73 75 63 68 20 61 73 20 74  values such as t
0b40: 68 65 20 6c 65 6e 67 74 68 20 6f 66 20 6b 65 79  he length of key
0b50: 20 61 6e 64 20 64 61 74 61 20 61 72 65 20 73 74   and data are st
0b60: 6f 72 65 64 20 75 73 69 6e 67 0a 61 20 76 61 72  ored using.a var
0b70: 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 65 6e 63  iable-length enc
0b80: 6f 64 69 6e 67 20 73 6f 20 74 68 61 74 20 6f 6e  oding so that on
0b90: 6c 79 20 6f 6e 65 20 6f 72 20 74 77 6f 20 62 79  ly one or two by
0ba0: 74 65 73 20 61 72 65 20 72 65 71 75 69 72 65 64  tes are required
0bb0: 20 74 6f 0a 73 74 6f 72 65 20 74 68 65 20 6d 6f   to.store the mo
0bc0: 73 74 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 73 20  st common cases 
0bd0: 62 75 74 20 75 70 20 74 6f 20 36 34 2d 62 69 74  but up to 64-bit
0be0: 73 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  s of information
0bf0: 20 63 61 6e 20 62 65 20 65 6e 63 6f 64 65 64 0a   can be encoded.
0c00: 69 66 20 6e 65 65 64 65 64 2e 20 0a 49 6e 74 65  if needed. .Inte
0c10: 67 65 72 20 61 6e 64 20 66 6c 6f 61 74 69 6e 67  ger and floating
0c20: 20 70 6f 69 6e 74 20 64 61 74 61 20 69 73 20 73   point data is s
0c30: 74 6f 72 65 64 20 6f 6e 20 74 68 65 20 64 69 73  tored on the dis
0c40: 6b 20 69 6e 20 62 69 6e 61 72 79 20 72 61 74 68  k in binary rath
0c50: 65 72 0a 74 68 61 6e 20 62 65 69 6e 67 20 63 6f  er.than being co
0c60: 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 41 53 43  nverted into ASC
0c70: 49 49 20 61 73 20 69 6e 20 53 51 4c 69 74 65 20  II as in SQLite 
0c80: 76 65 72 73 69 6f 6e 20 32 2e 38 2e 0a 54 68 65  version 2.8..The
0c90: 73 65 20 63 68 61 6e 67 65 73 20 74 61 6b 65 6e  se changes taken
0ca0: 20 74 6f 67 65 74 68 65 72 20 72 65 73 75 6c 74   together result
0cb0: 20 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c   in database fil
0cc0: 65 73 20 74 68 61 74 20 61 72 65 20 74 79 70 69  es that are typi
0cd0: 63 61 6c 6c 79 0a 32 35 25 20 74 6f 20 33 35 25  cally.25% to 35%
0ce0: 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 74 68   smaller than th
0cf0: 65 20 65 71 75 69 76 61 6c 65 6e 74 20 66 69 6c  e equivalent fil
0d00: 65 73 20 69 6e 20 53 51 4c 69 74 65 20 76 65 72  es in SQLite ver
0d10: 73 69 6f 6e 20 32 2e 38 2e 0a 3c 2f 70 3e 0a 0a  sion 2.8..</p>..
0d20: 3c 70 3e 0a 44 65 74 61 69 6c 73 20 6f 66 20 74  <p>.Details of t
0d30: 68 65 20 6c 6f 77 2d 6c 65 76 65 6c 20 42 2d 74  he low-level B-t
0d40: 72 65 65 20 66 6f 72 6d 61 74 20 75 73 65 64 20  ree format used 
0d50: 69 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f  in SQLite versio
0d60: 6e 20 33 2e 30 20 63 61 6e 0a 62 65 20 66 6f 75  n 3.0 can.be fou
0d70: 6e 64 20 69 6e 20 68 65 61 64 65 72 20 63 6f 6d  nd in header com
0d80: 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 0a 3c 61  ments to the .<a
0d90: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77   href="http://ww
0da0: 77 2e 73 71 6c 69 74 65 2e 6f 72 67 2f 63 76 73  w.sqlite.org/cvs
0db0: 74 72 61 63 2f 67 65 74 66 69 6c 65 2f 73 71 6c  trac/getfile/sql
0dc0: 69 74 65 2f 73 72 63 2f 62 74 72 65 65 2e 63 22  ite/src/btree.c"
0dd0: 3e 62 74 72 65 65 2e 63 3c 2f 61 3e 0a 73 6f 75  >btree.c</a>.sou
0de0: 72 63 65 20 66 69 6c 65 2e 0a 3c 2f 70 3e 0a 0a  rce file..</p>..
0df0: 3c 68 33 3e 4d 61 6e 69 66 65 73 74 20 54 79 70  <h3>Manifest Typ
0e00: 69 6e 67 20 61 6e 64 20 42 4c 4f 42 20 53 75 70  ing and BLOB Sup
0e10: 70 6f 72 74 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 53  port</h3>..<p>.S
0e20: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 32 2e  QLite version 2.
0e30: 38 20 77 69 6c 6c 20 64 65 61 6c 20 77 69 74 68  8 will deal with
0e40: 20 64 61 74 61 20 69 6e 20 76 61 72 69 6f 75 73   data in various
0e50: 20 66 6f 72 6d 61 74 73 20 69 6e 74 65 72 6e 61   formats interna
0e60: 6c 6c 79 2c 0a 62 75 74 20 77 68 65 6e 20 77 72  lly,.but when wr
0e70: 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 69 73  iting to the dis
0e80: 6b 20 6f 72 20 69 6e 74 65 72 61 63 74 69 6e 67  k or interacting
0e90: 20 74 68 72 6f 75 67 68 20 69 74 73 20 41 50 49   through its API
0ea0: 2c 20 53 51 4c 69 74 65 20 32 2e 38 0a 61 6c 77  , SQLite 2.8.alw
0eb0: 61 79 73 20 63 6f 6e 76 65 72 74 73 20 64 61 74  ays converts dat
0ec0: 61 20 69 6e 74 6f 20 41 53 43 49 49 20 74 65 78  a into ASCII tex
0ed0: 74 2e 20 20 53 51 4c 69 74 65 20 33 2e 30 2c 20  t.  SQLite 3.0, 
0ee0: 69 6e 20 63 6f 6e 74 72 61 73 74 2c 20 65 78 70  in contrast, exp
0ef0: 6f 73 65 73 20 0a 69 74 73 20 69 6e 74 65 72 6e  oses .its intern
0f00: 61 6c 20 64 61 74 61 20 72 65 70 72 65 73 65 6e  al data represen
0f10: 74 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 75  tations to the u
0f20: 73 65 72 20 61 6e 64 20 73 74 6f 72 65 73 20 62  ser and stores b
0f30: 69 6e 61 72 79 20 72 65 70 72 65 73 65 6e 74 61  inary representa
0f40: 74 69 6f 6e 73 0a 74 6f 20 64 69 73 6b 20 77 68  tions.to disk wh
0f50: 65 6e 20 61 70 70 72 6f 70 72 69 61 74 65 2e 20  en appropriate. 
0f60: 20 54 68 65 20 65 78 70 6f 73 69 6e 67 20 6f 66   The exposing of
0f70: 20 6e 6f 6e 2d 41 53 43 49 49 20 72 65 70 72 65   non-ASCII repre
0f80: 73 65 6e 74 61 74 69 6f 6e 73 20 77 61 73 0a 61  sentations was.a
0f90: 64 64 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f  dded in order to
0fa0: 20 73 75 70 70 6f 72 74 20 42 4c 4f 42 73 2e 0a   support BLOBs..
0fb0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 51 4c 69 74 65  </p>..<p>.SQLite
0fc0: 20 76 65 72 73 69 6f 6e 20 32 2e 38 20 68 61 64   version 2.8 had
0fd0: 20 74 68 65 20 66 65 61 74 75 72 65 20 74 68 61   the feature tha
0fe0: 74 20 61 6e 79 20 74 79 70 65 20 6f 66 20 64 61  t any type of da
0ff0: 74 61 20 63 6f 75 6c 64 20 62 65 20 73 74 6f 72  ta could be stor
1000: 65 64 0a 69 6e 20 61 6e 79 20 74 61 62 6c 65 20  ed.in any table 
1010: 63 6f 6c 75 6d 6e 20 72 65 67 61 72 64 6c 65 73  column regardles
1020: 73 20 6f 66 20 74 68 65 20 64 65 63 6c 61 72 65  s of the declare
1030: 64 20 74 79 70 65 20 6f 66 20 74 68 61 74 20 63  d type of that c
1040: 6f 6c 75 6d 6e 2e 20 20 54 68 69 73 0a 66 65 61  olumn.  This.fea
1050: 74 75 72 65 20 69 73 20 72 65 74 61 69 6e 65 64  ture is retained
1060: 20 69 6e 20 76 65 72 73 69 6f 6e 20 33 2e 30 2c   in version 3.0,
1070: 20 74 68 6f 75 67 68 20 69 6e 20 61 20 73 6c 69   though in a sli
1080: 67 68 74 6c 79 20 6d 6f 64 69 66 69 65 64 20 66  ghtly modified f
1090: 6f 72 6d 2e 0a 45 61 63 68 20 74 61 62 6c 65 20  orm..Each table 
10a0: 63 6f 6c 75 6d 6e 20 77 69 6c 6c 20 73 74 6f 72  column will stor
10b0: 65 20 61 6e 79 20 74 79 70 65 20 6f 66 20 64 61  e any type of da
10c0: 74 61 2c 20 74 68 6f 75 67 68 20 63 6f 6c 75 6d  ta, though colum
10d0: 6e 73 20 68 61 76 65 20 61 6e 0a 61 66 66 69 6e  ns have an.affin
10e0: 69 74 79 20 66 6f 72 20 74 68 65 20 66 6f 72 6d  ity for the form
10f0: 61 74 20 6f 66 20 64 61 74 61 20 64 65 66 69 6e  at of data defin
1100: 65 64 20 62 79 20 74 68 65 69 72 20 64 65 63 6c  ed by their decl
1110: 61 72 65 64 20 64 61 74 61 74 79 70 65 2e 0a 57  ared datatype..W
1120: 68 65 6e 20 64 61 74 61 20 69 73 20 69 6e 73 65  hen data is inse
1130: 72 74 65 64 20 69 6e 74 6f 20 61 20 63 6f 6c 75  rted into a colu
1140: 6d 6e 2c 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20  mn, that column 
1150: 77 69 6c 6c 20 6d 61 6b 65 20 61 74 20 61 74 74  will make at att
1160: 65 6d 70 74 0a 74 6f 20 63 6f 6e 76 65 72 74 20  empt.to convert 
1170: 74 68 65 20 64 61 74 61 20 66 6f 72 6d 61 74 20  the data format 
1180: 69 6e 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e 73  into the columns
1190: 20 64 65 63 6c 61 72 65 64 20 74 79 70 65 2e 20   declared type. 
11a0: 20 20 41 6c 6c 20 53 51 4c 0a 64 61 74 61 62 61    All SQL.databa
11b0: 73 65 20 65 6e 67 69 6e 65 73 20 64 6f 20 74 68  se engines do th
11c0: 69 73 2e 20 20 54 68 65 20 64 69 66 66 65 72 65  is.  The differe
11d0: 6e 63 65 20 69 73 20 74 68 61 74 20 53 51 4c 69  nce is that SQLi
11e0: 74 65 20 33 2e 30 20 77 69 6c 6c 20 0a 73 74 69  te 3.0 will .sti
11f0: 6c 6c 20 73 74 6f 72 65 20 74 68 65 20 64 61 74  ll store the dat
1200: 61 20 65 76 65 6e 20 69 66 20 61 20 66 6f 72 6d  a even if a form
1210: 61 74 20 63 6f 6e 76 65 72 73 69 6f 6e 20 69 73  at conversion is
1220: 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 2e 0a 3c   not possible..<
1230: 2f 70 3e 0a 0a 3c 70 3e 0a 46 6f 72 20 65 78 61  /p>..<p>.For exa
1240: 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20 68 61 76  mple, if you hav
1250: 65 20 61 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e  e a table column
1260: 20 64 65 63 6c 61 72 65 64 20 74 6f 20 62 65 20   declared to be 
1270: 6f 66 20 74 79 70 65 20 22 49 4e 54 45 47 45 52  of type "INTEGER
1280: 22 0a 61 6e 64 20 79 6f 75 20 74 72 79 20 74 6f  ".and you try to
1290: 20 69 6e 73 65 72 74 20 61 20 73 74 72 69 6e 67   insert a string
12a0: 2c 20 74 68 65 20 63 6f 6c 75 6d 6e 20 77 69 6c  , the column wil
12b0: 6c 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 74 65  l look at the te
12c0: 78 74 20 73 74 72 69 6e 67 0a 61 6e 64 20 73 65  xt string.and se
12d0: 65 20 69 66 20 69 74 20 6c 6f 6f 6b 73 20 6c 69  e if it looks li
12e0: 6b 65 20 61 20 6e 75 6d 62 65 72 2e 20 20 49 66  ke a number.  If
12f0: 20 74 68 65 20 73 74 72 69 6e 67 20 64 6f 65 73   the string does
1300: 20 6c 6f 6f 6b 20 6c 69 6b 65 20 61 20 6e 75 6d   look like a num
1310: 62 65 72 0a 69 74 20 69 73 20 63 6f 6e 76 65 72  ber.it is conver
1320: 74 65 64 20 69 6e 74 6f 20 61 20 6e 75 6d 62 65  ted into a numbe
1330: 72 20 61 6e 64 20 69 6e 74 6f 20 61 6e 20 69 6e  r and into an in
1340: 74 65 67 65 72 20 69 66 20 74 68 65 20 6e 75 6d  teger if the num
1350: 62 65 72 20 64 6f 65 73 20 6e 6f 74 0a 68 61 76  ber does not.hav
1360: 65 20 61 20 66 72 61 63 74 69 6f 6e 61 6c 20 70  e a fractional p
1370: 61 72 74 2c 20 61 6e 64 20 73 74 6f 72 65 64 20  art, and stored 
1380: 74 68 61 74 20 77 61 79 2e 20 20 42 75 74 20 69  that way.  But i
1390: 66 20 74 68 65 20 73 74 72 69 6e 67 20 69 73 20  f the string is 
13a0: 6e 6f 74 0a 61 20 77 65 6c 6c 2d 66 6f 72 6d 65  not.a well-forme
13b0: 64 20 6e 75 6d 62 65 72 20 69 74 20 69 73 20 73  d number it is s
13c0: 74 69 6c 6c 20 73 74 6f 72 65 64 20 61 73 20 61  till stored as a
13d0: 20 73 74 72 69 6e 67 2e 20 20 41 20 63 6f 6c 75   string.  A colu
13e0: 6d 6e 20 77 69 74 68 20 61 0a 74 79 70 65 20 6f  mn with a.type o
13f0: 66 20 22 54 45 58 54 22 20 74 72 69 65 73 20 74  f "TEXT" tries t
1400: 6f 20 63 6f 6e 76 65 72 74 20 6e 75 6d 62 65 72  o convert number
1410: 73 20 69 6e 74 6f 20 61 6e 20 41 53 43 49 49 2d  s into an ASCII-
1420: 54 65 78 74 20 72 65 70 72 65 73 65 6e 74 61 74  Text representat
1430: 69 6f 6e 0a 62 65 66 6f 72 65 20 73 74 6f 72 69  ion.before stori
1440: 6e 67 20 74 68 65 6d 2e 20 20 42 75 74 20 42 4c  ng them.  But BL
1450: 4f 42 73 20 61 72 65 20 73 74 6f 72 65 64 20 69  OBs are stored i
1460: 6e 20 54 45 58 54 20 63 6f 6c 75 6d 6e 73 20 61  n TEXT columns a
1470: 73 20 42 4c 4f 42 73 20 62 65 63 61 75 73 65 0a  s BLOBs because.
1480: 79 6f 75 20 63 61 6e 6e 6f 74 20 69 6e 20 67 65  you cannot in ge
1490: 6e 65 72 61 6c 20 63 6f 6e 76 65 72 74 20 61 20  neral convert a 
14a0: 42 4c 4f 42 20 69 6e 74 6f 20 74 65 78 74 2e 0a  BLOB into text..
14b0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 49 6e 20 6d 6f 73  </p>..<p>.In mos
14c0: 74 20 6f 74 68 65 72 20 53 51 4c 20 64 61 74 61  t other SQL data
14d0: 62 61 73 65 20 65 6e 67 69 6e 65 73 20 74 68 65  base engines the
14e0: 20 64 61 74 61 74 79 70 65 20 69 73 20 61 73 73   datatype is ass
14f0: 6f 63 69 61 74 65 64 20 77 69 74 68 0a 74 68 65  ociated with.the
1500: 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68   table column th
1510: 61 74 20 68 6f 6c 64 73 20 74 68 65 20 64 61 74  at holds the dat
1520: 61 20 2d 20 77 69 74 68 20 74 68 65 20 64 61 74  a - with the dat
1530: 61 20 63 6f 6e 74 61 69 6e 65 72 2e 0a 49 6e 20  a container..In 
1540: 53 51 4c 69 74 65 20 33 2e 30 2c 20 74 68 65 20  SQLite 3.0, the 
1550: 64 61 74 61 74 79 70 65 20 69 73 20 61 73 73 6f  datatype is asso
1560: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20  ciated with the 
1570: 64 61 74 61 20 69 74 73 65 6c 66 2c 20 6e 6f 74  data itself, not
1580: 0a 77 69 74 68 20 69 74 73 20 63 6f 6e 74 61 69  .with its contai
1590: 6e 65 72 2e 0a 3c 61 20 68 72 65 66 3d 22 68 74  ner..<a href="ht
15a0: 74 70 3a 2f 2f 77 77 77 2e 70 61 75 6c 67 72 61  tp://www.paulgra
15b0: 68 61 6d 2e 63 6f 6d 2f 22 3e 50 61 75 6c 20 47  ham.com/">Paul G
15c0: 72 61 68 61 6d 3c 2f 61 3e 20 69 6e 20 68 69 73  raham</a> in his
15d0: 20 62 6f 6f 6b 20 0a 3c 61 20 68 72 65 66 3d 22   book .<a href="
15e0: 68 74 74 70 3a 2f 2f 77 77 77 2e 70 61 75 6c 67  http://www.paulg
15f0: 72 61 68 61 6d 2e 63 6f 6d 2f 61 63 6c 2e 68 74  raham.com/acl.ht
1600: 6d 6c 22 3e 3c 69 3e 41 4e 53 49 20 43 6f 6d 6d  ml"><i>ANSI Comm
1610: 6f 6e 20 4c 69 73 70 3c 2f 69 3e 3c 2f 61 3e 0a  on Lisp</i></a>.
1620: 63 61 6c 6c 73 20 74 68 69 73 20 70 72 6f 70 65  calls this prope
1630: 72 74 79 20 22 4d 61 6e 69 66 65 73 74 20 54 79  rty "Manifest Ty
1640: 70 69 6e 67 22 2e 0a 4f 74 68 65 72 20 77 72 69  ping"..Other wri
1650: 74 65 72 73 20 68 61 76 65 20 6f 74 68 65 72 20  ters have other 
1660: 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20  definitions for 
1670: 74 68 65 20 74 65 72 6d 20 22 6d 61 6e 69 66 65  the term "manife
1680: 73 74 20 74 79 70 69 6e 67 22 2c 0a 73 6f 20 62  st typing",.so b
1690: 65 77 61 72 65 20 6f 66 20 63 6f 6e 66 75 73 69  eware of confusi
16a0: 6f 6e 2e 20 20 42 75 74 20 62 79 20 77 68 61 74  on.  But by what
16b0: 65 76 65 72 20 6e 61 6d 65 2c 20 74 68 61 74 20  ever name, that 
16c0: 69 73 20 74 68 65 20 64 61 74 61 74 79 70 65 0a  is the datatype.
16d0: 6d 6f 64 65 6c 20 73 75 70 70 6f 72 74 65 64 20  model supported 
16e0: 62 79 20 53 51 4c 69 74 65 20 33 2e 30 2e 0a 3c  by SQLite 3.0..<
16f0: 2f 70 3e 0a 0a 3c 70 3e 0a 41 64 64 69 74 69 6f  /p>..<p>.Additio
1700: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  nal information 
1710: 61 62 6f 75 74 20 64 61 74 61 74 79 70 65 73 20  about datatypes 
1720: 69 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f  in SQLite versio
1730: 6e 20 33 2e 30 20 69 73 0a 61 76 61 69 6c 61 62  n 3.0 is.availab
1740: 6c 65 0a 3c 61 20 68 72 65 66 3d 22 64 61 74 61  le.<a href="data
1750: 74 79 70 65 33 2e 68 74 6d 6c 22 3e 73 65 70 61  type3.html">sepa
1760: 72 61 74 65 6c 79 3c 2f 61 3e 2e 0a 3c 2f 70 3e  rately</a>..</p>
1770: 0a 0a 3c 68 33 3e 53 75 70 70 6f 72 74 20 66 6f  ..<h3>Support fo
1780: 72 20 55 54 46 2d 38 20 61 6e 64 20 55 54 46 2d  r UTF-8 and UTF-
1790: 31 36 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 54 68 65  16</h3>..<p>.The
17a0: 20 6e 65 77 20 41 50 49 20 66 6f 72 20 53 51 4c   new API for SQL
17b0: 69 74 65 20 33 2e 30 20 63 6f 6e 74 61 69 6e 73  ite 3.0 contains
17c0: 20 72 6f 75 74 69 6e 65 73 20 74 68 61 74 20 61   routines that a
17d0: 63 63 65 70 74 20 74 65 78 74 20 61 73 0a 62 6f  ccept text as.bo
17e0: 74 68 20 55 54 46 2d 38 20 61 6e 64 20 55 54 46  th UTF-8 and UTF
17f0: 2d 31 36 20 69 6e 20 74 68 65 20 6e 61 74 69 76  -16 in the nativ
1800: 65 20 62 79 74 65 20 6f 72 64 65 72 20 6f 66 20  e byte order of 
1810: 74 68 65 20 68 6f 73 74 20 6d 61 63 68 69 6e 65  the host machine
1820: 2e 0a 45 61 63 68 20 64 61 74 61 62 61 73 65 20  ..Each database 
1830: 66 69 6c 65 20 6d 61 6e 61 67 65 73 20 74 65 78  file manages tex
1840: 74 20 61 73 20 65 69 74 68 65 72 20 55 54 46 2d  t as either UTF-
1850: 38 2c 20 55 54 46 2d 31 36 42 45 20 28 62 69 67  8, UTF-16BE (big
1860: 2d 65 6e 64 69 61 6e 29 2c 0a 6f 72 20 55 54 46  -endian),.or UTF
1870: 2d 31 36 4c 45 20 28 6c 69 74 74 6c 65 2d 65 6e  -16LE (little-en
1880: 64 69 61 6e 29 2e 20 20 49 6e 74 65 72 6e 61 6c  dian).  Internal
1890: 6c 79 20 61 6e 64 20 69 6e 20 74 68 65 20 64 69  ly and in the di
18a0: 73 6b 20 66 69 6c 65 2c 20 74 68 65 0a 73 61 6d  sk file, the.sam
18b0: 65 20 74 65 78 74 20 72 65 70 72 65 73 65 6e 74  e text represent
18c0: 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 65 76  ation is used ev
18d0: 65 72 79 77 68 65 72 65 2e 20 20 49 66 20 74 68  erywhere.  If th
18e0: 65 20 74 65 78 74 20 72 65 70 72 65 73 65 6e 74  e text represent
18f0: 61 74 69 6f 6e 0a 73 70 65 63 69 66 69 65 64 20  ation.specified 
1900: 62 79 20 74 68 65 20 64 61 74 61 62 61 73 65 20  by the database 
1910: 66 69 6c 65 20 28 69 6e 20 74 68 65 20 66 69 6c  file (in the fil
1920: 65 20 68 65 61 64 65 72 29 20 64 6f 65 73 20 6e  e header) does n
1930: 6f 74 20 6d 61 74 63 68 0a 74 68 65 20 74 65 78  ot match.the tex
1940: 74 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e  t representation
1950: 20 72 65 71 75 69 72 65 64 20 62 79 20 74 68 65   required by the
1960: 20 69 6e 74 65 72 66 61 63 65 20 72 6f 75 74 69   interface routi
1970: 6e 65 73 2c 20 74 68 65 6e 20 74 65 78 74 0a 69  nes, then text.i
1980: 73 20 63 6f 6e 76 65 72 74 65 64 20 6f 6e 2d 74  s converted on-t
1990: 68 65 2d 66 6c 79 2e 0a 43 6f 6e 73 74 61 6e 74  he-fly..Constant
19a0: 6c 79 20 63 6f 6e 76 65 72 74 69 6e 67 20 74 65  ly converting te
19b0: 78 74 20 66 72 6f 6d 20 6f 6e 65 20 72 65 70 72  xt from one repr
19c0: 65 73 65 6e 74 61 74 69 6f 6e 20 74 6f 20 61 6e  esentation to an
19d0: 6f 74 68 65 72 20 63 61 6e 20 62 65 0a 63 6f 6d  other can be.com
19e0: 70 75 74 61 74 69 6f 6e 61 6c 6c 79 20 65 78 70  putationally exp
19f0: 65 6e 73 69 76 65 2c 20 73 6f 20 69 74 20 69 73  ensive, so it is
1a00: 20 73 75 67 67 65 73 74 65 64 20 74 68 61 74 20   suggested that 
1a10: 70 72 6f 67 72 61 6d 6d 65 72 73 20 63 68 6f 6f  programmers choo
1a20: 73 65 20 61 0a 73 69 6e 67 6c 65 20 72 65 70 72  se a.single repr
1a30: 65 73 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 73  esentation and s
1a40: 74 69 63 6b 20 77 69 74 68 20 69 74 20 74 68 72  tick with it thr
1a50: 6f 75 67 68 6f 75 74 20 74 68 65 69 72 20 61 70  oughout their ap
1a60: 70 6c 69 63 61 74 69 6f 6e 2e 0a 3c 2f 70 3e 0a  plication..</p>.
1a70: 0a 3c 70 3e 0a 49 6e 20 74 68 65 20 63 75 72 72  .<p>.In the curr
1a80: 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ent implementati
1a90: 6f 6e 20 6f 66 20 53 51 4c 69 74 65 2c 20 74 68  on of SQLite, th
1aa0: 65 20 53 51 4c 20 70 61 72 73 65 72 20 6f 6e 6c  e SQL parser onl
1ab0: 79 20 77 6f 72 6b 73 0a 77 69 74 68 20 55 54 46  y works.with UTF
1ac0: 2d 38 20 74 65 78 74 2e 20 20 53 6f 20 69 66 20  -8 text.  So if 
1ad0: 79 6f 75 20 73 75 70 70 6c 79 20 55 54 46 2d 31  you supply UTF-1
1ae0: 36 20 74 65 78 74 20 69 74 20 77 69 6c 6c 20 62  6 text it will b
1af0: 65 20 63 6f 6e 76 65 72 74 65 64 2e 0a 54 68 69  e converted..Thi
1b00: 73 20 69 73 20 6a 75 73 74 20 61 6e 20 69 6d 70  s is just an imp
1b10: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 73 75  lementation issu
1b20: 65 20 61 6e 64 20 74 68 65 72 65 20 69 73 20 6e  e and there is n
1b30: 6f 74 68 69 6e 67 20 74 6f 20 70 72 65 76 65 6e  othing to preven
1b40: 74 0a 66 75 74 75 72 65 20 76 65 72 73 69 6f 6e  t.future version
1b50: 73 20 6f 66 20 53 51 4c 69 74 65 20 66 72 6f 6d  s of SQLite from
1b60: 20 70 61 72 73 69 6e 67 20 55 54 46 2d 31 36 20   parsing UTF-16 
1b70: 65 6e 63 6f 64 65 64 20 53 51 4c 20 6e 61 74 69  encoded SQL nati
1b80: 76 65 6c 79 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  vely..</p>..<p>.
1b90: 57 68 65 6e 20 63 72 65 61 74 69 6e 67 20 6e 65  When creating ne
1ba0: 77 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20 53  w user-defined S
1bb0: 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64  QL functions and
1bc0: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65   collating seque
1bd0: 6e 63 65 73 2c 0a 65 61 63 68 20 66 75 6e 63 74  nces,.each funct
1be0: 69 6f 6e 20 6f 72 20 63 6f 6c 6c 61 74 69 6e 67  ion or collating
1bf0: 20 73 65 71 75 65 6e 63 65 20 63 61 6e 20 73 70   sequence can sp
1c00: 65 63 69 66 79 20 69 74 20 69 66 20 77 6f 72 6b  ecify it if work
1c10: 73 20 77 69 74 68 0a 55 54 46 2d 38 2c 20 55 54  s with.UTF-8, UT
1c20: 46 2d 31 36 62 65 2c 20 6f 72 20 55 54 46 2d 31  F-16be, or UTF-1
1c30: 36 6c 65 2e 20 20 53 65 70 61 72 61 74 65 20 69  6le.  Separate i
1c40: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63  mplementations c
1c50: 61 6e 20 62 65 20 72 65 67 69 73 74 65 72 65 64  an be registered
1c60: 0a 66 6f 72 20 65 61 63 68 20 65 6e 63 6f 64 69  .for each encodi
1c70: 6e 67 2e 20 20 20 49 66 20 61 6e 20 53 51 4c 20  ng.   If an SQL 
1c80: 66 75 6e 63 74 69 6f 6e 20 6f 72 20 63 6f 6c 6c  function or coll
1c90: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20  ating sequences 
1ca0: 69 73 20 72 65 71 75 69 72 65 64 0a 62 75 74 20  is required.but 
1cb0: 61 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 74 68  a version for th
1cc0: 65 20 63 75 72 72 65 6e 74 20 74 65 78 74 20 65  e current text e
1cd0: 6e 63 6f 64 69 6e 67 20 69 73 20 6e 6f 74 20 61  ncoding is not a
1ce0: 76 61 69 6c 61 62 6c 65 2c 20 74 68 65 6e 20 0a  vailable, then .
1cf0: 74 68 65 20 74 65 78 74 20 69 73 20 61 75 74 6f  the text is auto
1d00: 6d 61 74 69 63 61 6c 6c 79 20 63 6f 6e 76 65 72  matically conver
1d10: 74 65 64 2e 20 20 41 73 20 62 65 66 6f 72 65 2c  ted.  As before,
1d20: 20 74 68 69 73 20 63 6f 6e 76 65 72 73 69 6f 6e   this conversion
1d30: 20 74 61 6b 65 73 0a 63 6f 6d 70 75 74 61 74 69   takes.computati
1d40: 6f 6e 20 74 69 6d 65 2c 20 73 6f 20 70 72 6f 67  on time, so prog
1d50: 72 61 6d 6d 65 72 73 20 61 72 65 20 61 64 76 69  rammers are advi
1d60: 73 65 64 20 74 6f 20 70 69 63 6b 20 61 20 73 69  sed to pick a si
1d70: 6e 67 6c 65 0a 65 6e 63 6f 64 69 6e 67 20 61 6e  ngle.encoding an
1d80: 64 20 73 74 69 63 6b 20 77 69 74 68 20 69 74 20  d stick with it 
1d90: 69 6e 20 6f 72 64 65 72 20 74 6f 20 6d 69 6e 69  in order to mini
1da0: 6d 69 7a 65 20 74 68 65 20 61 6d 6f 75 6e 74 20  mize the amount 
1db0: 6f 66 20 75 6e 6e 65 63 65 73 73 61 72 79 0a 66  of unnecessary.f
1dc0: 6f 72 6d 61 74 20 6a 75 67 67 6c 69 6e 67 2e 0a  ormat juggling..
1dd0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 51 4c 69 74 65  </p>..<p>.SQLite
1de0: 20 69 73 20 6e 6f 74 20 70 61 72 74 69 63 75 6c   is not particul
1df0: 61 72 20 61 62 6f 75 74 20 74 68 65 20 74 65 78  ar about the tex
1e00: 74 20 69 74 20 72 65 63 65 69 76 65 73 20 61 6e  t it receives an
1e10: 64 20 69 73 20 6d 6f 72 65 20 74 68 61 6e 0a 68  d is more than.h
1e20: 61 70 70 79 20 74 6f 20 70 72 6f 63 65 73 73 20  appy to process 
1e30: 74 65 78 74 20 73 74 72 69 6e 67 73 20 74 68 61  text strings tha
1e40: 74 20 61 72 65 20 6e 6f 74 20 6e 6f 72 6d 61 6c  t are not normal
1e50: 69 7a 65 64 20 6f 72 20 65 76 65 6e 0a 77 65 6c  ized or even.wel
1e60: 6c 2d 66 6f 72 6d 65 64 20 55 54 46 2d 38 20 6f  l-formed UTF-8 o
1e70: 72 20 55 54 46 2d 31 36 2e 20 20 54 68 75 73 2c  r UTF-16.  Thus,
1e80: 20 70 72 6f 67 72 61 6d 6d 65 72 73 20 77 68 6f   programmers who
1e90: 20 77 61 6e 74 20 74 6f 20 73 74 6f 72 65 0a 49   want to store.I
1ea0: 53 30 38 38 35 39 20 64 61 74 61 20 63 61 6e 20  S08859 data can 
1eb0: 64 6f 20 73 6f 20 75 73 69 6e 67 20 74 68 65 20  do so using the 
1ec0: 55 54 46 2d 38 20 69 6e 74 65 72 66 61 63 65 73  UTF-8 interfaces
1ed0: 2e 20 20 41 73 20 6c 6f 6e 67 20 61 73 20 6e 6f  .  As long as no
1ee0: 0a 61 74 74 65 6d 70 74 73 20 61 72 65 20 6d 61  .attempts are ma
1ef0: 64 65 20 74 6f 20 75 73 65 20 61 20 55 54 46 2d  de to use a UTF-
1f00: 31 36 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71  16 collating seq
1f10: 75 65 6e 63 65 20 6f 72 20 53 51 4c 20 66 75 6e  uence or SQL fun
1f20: 63 74 69 6f 6e 2c 0a 74 68 65 20 62 79 74 65 20  ction,.the byte 
1f30: 73 65 71 75 65 6e 63 65 20 6f 66 20 74 68 65 20  sequence of the 
1f40: 74 65 78 74 20 77 69 6c 6c 20 6e 6f 74 20 62 65  text will not be
1f50: 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 61 6e 79   modified in any
1f60: 20 77 61 79 2e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e   way..</p>..<h3>
1f70: 55 73 65 72 2d 64 65 66 69 6e 65 64 20 43 6f 6c  User-defined Col
1f80: 6c 61 74 69 6e 67 20 53 65 71 75 65 6e 63 65 73  lating Sequences
1f90: 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 41 20 63 6f 6c  </h3>..<p>.A col
1fa0: 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20  lating sequence 
1fb0: 69 73 20 6a 75 73 74 20 61 20 64 65 66 69 6e 65  is just a define
1fc0: 64 20 6f 72 64 65 72 20 66 6f 72 20 74 65 78 74  d order for text
1fd0: 2e 20 20 57 68 65 6e 20 53 51 4c 69 74 65 20 33  .  When SQLite 3
1fe0: 2e 30 0a 73 6f 72 74 73 20 28 6f 72 20 75 73 65  .0.sorts (or use
1ff0: 73 20 61 20 63 6f 6d 70 61 72 69 73 6f 6e 20 6f  s a comparison o
2000: 70 65 72 61 74 6f 72 20 6c 69 6b 65 20 22 3c 22  perator like "<"
2010: 20 6f 72 20 22 3e 3d 22 29 20 74 68 65 20 73 6f   or ">=") the so
2020: 72 74 20 6f 72 64 65 72 0a 69 73 20 66 69 72 73  rt order.is firs
2030: 74 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20  t determined by 
2040: 74 68 65 20 64 61 74 61 20 74 79 70 65 2e 0a 3c  the data type..<
2050: 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 4e 55  /p>..<ul>.<li>NU
2060: 4c 4c 73 20 73 6f 72 74 20 66 69 72 73 74 3c 2f  LLs sort first</
2070: 6c 69 3e 0a 3c 6c 69 3e 4e 75 6d 65 72 69 63 20  li>.<li>Numeric 
2080: 76 61 6c 75 65 73 20 73 6f 72 74 20 6e 65 78 74  values sort next
2090: 20 69 6e 20 6e 75 6d 65 72 69 63 61 6c 20 6f 72   in numerical or
20a0: 64 65 72 3c 2f 6c 69 3e 0a 3c 6c 69 3e 54 65 78  der</li>.<li>Tex
20b0: 74 20 76 61 6c 75 65 73 20 63 6f 6d 65 20 61 66  t values come af
20c0: 74 65 72 20 6e 75 6d 65 72 69 63 73 3c 2f 6c 69  ter numerics</li
20d0: 3e 0a 3c 6c 69 3e 42 4c 4f 42 73 20 73 6f 72 74  >.<li>BLOBs sort
20e0: 20 6c 61 73 74 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e   last</li>.</ul>
20f0: 0a 0a 3c 70 3e 0a 43 6f 6c 6c 61 74 69 6e 67 20  ..<p>.Collating 
2100: 73 65 71 75 65 6e 63 65 73 20 61 72 65 20 75 73  sequences are us
2110: 65 64 20 66 6f 72 20 63 6f 6d 70 61 72 69 6e 67  ed for comparing
2120: 20 74 77 6f 20 74 65 78 74 20 73 74 72 69 6e 67   two text string
2130: 73 2e 0a 54 68 65 20 63 6f 6c 6c 61 74 69 6e 67  s..The collating
2140: 20 73 65 71 75 65 6e 63 65 20 64 6f 65 73 20 6e   sequence does n
2150: 6f 74 20 63 68 61 6e 67 65 20 74 68 65 20 6f 72  ot change the or
2160: 64 65 72 69 6e 67 20 6f 66 20 4e 55 4c 4c 73 2c  dering of NULLs,
2170: 20 6e 75 6d 62 65 72 73 2c 0a 6f 72 20 42 4c 4f   numbers,.or BLO
2180: 42 73 2c 20 6f 6e 6c 79 20 74 65 78 74 2e 0a 3c  Bs, only text..<
2190: 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 63 6f 6c 6c 61  /p>..<p>.A colla
21a0: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73  ting sequence is
21b0: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20   implemented as 
21c0: 61 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20  a function that 
21d0: 74 61 6b 65 73 20 74 68 65 0a 74 77 6f 20 73 74  takes the.two st
21e0: 72 69 6e 67 73 20 62 65 69 6e 67 20 63 6f 6d 70  rings being comp
21f0: 61 72 65 64 20 61 73 20 69 6e 70 75 74 73 20 61  ared as inputs a
2200: 6e 64 20 72 65 74 75 72 6e 73 20 6e 65 67 61 74  nd returns negat
2210: 69 76 65 2c 20 7a 65 72 6f 2c 20 6f 72 0a 70 6f  ive, zero, or.po
2220: 73 69 74 69 76 65 20 69 66 20 74 68 65 20 66 69  sitive if the fi
2230: 72 73 74 20 73 74 72 69 6e 67 20 69 73 20 6c 65  rst string is le
2240: 73 73 20 74 68 61 6e 2c 20 65 71 75 61 6c 20 74  ss than, equal t
2250: 6f 2c 20 6f 72 20 67 72 65 61 74 65 72 20 74 68  o, or greater th
2260: 61 6e 0a 74 68 65 20 73 65 63 6f 6e 64 2e 0a 53  an.the second..S
2270: 51 4c 69 74 65 20 33 2e 30 20 63 6f 6d 65 73 20  QLite 3.0 comes 
2280: 77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 62 75  with a single bu
2290: 69 6c 74 2d 69 6e 20 63 6f 6c 6c 61 74 69 6e 67  ilt-in collating
22a0: 20 73 65 71 75 65 6e 63 65 20 6e 61 6d 65 64 20   sequence named 
22b0: 22 42 49 4e 41 52 59 22 0a 77 68 69 63 68 20 69  "BINARY".which i
22c0: 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 75 73  s implemented us
22d0: 69 6e 67 20 74 68 65 20 6d 65 6d 63 6d 70 28 29  ing the memcmp()
22e0: 20 72 6f 75 74 69 6e 65 20 66 72 6f 6d 20 74 68   routine from th
22f0: 65 20 73 74 61 6e 64 61 72 64 20 43 20 6c 69 62  e standard C lib
2300: 72 61 72 79 2e 0a 54 68 65 20 42 49 4e 41 52 59  rary..The BINARY
2310: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65   collating seque
2320: 6e 63 65 20 77 6f 72 6b 73 20 77 65 6c 6c 20 66  nce works well f
2330: 6f 72 20 45 6e 67 6c 69 73 68 20 74 65 78 74 2e  or English text.
2340: 20 20 46 6f 72 20 6f 74 68 65 72 0a 6c 61 6e 67    For other.lang
2350: 75 61 67 65 73 20 6f 72 20 6c 6f 63 61 6c 65 73  uages or locales
2360: 2c 20 61 6c 74 65 72 6e 61 74 69 76 65 20 63 6f  , alternative co
2370: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65  llating sequence
2380: 73 20 6d 61 79 20 62 65 20 70 72 65 66 65 72 72  s may be preferr
2390: 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68  ed..</p>..<p>.Th
23a0: 65 20 64 65 63 69 73 69 6f 6e 20 6f 66 20 77 68  e decision of wh
23b0: 69 63 68 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65  ich collating se
23c0: 71 75 65 6e 63 65 20 74 6f 20 75 73 65 20 69 73  quence to use is
23d0: 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 20 74   controlled by t
23e0: 68 65 0a 43 4f 4c 4c 41 54 45 20 63 6c 61 75 73  he.COLLATE claus
23f0: 65 20 69 6e 20 53 51 4c 2e 20 20 41 20 43 4f 4c  e in SQL.  A COL
2400: 4c 41 54 45 20 63 6c 61 75 73 65 20 63 61 6e 20  LATE clause can 
2410: 6f 63 63 75 72 20 6f 6e 20 61 20 74 61 62 6c 65  occur on a table
2420: 20 64 65 66 69 6e 69 74 69 6f 6e 2c 0a 74 6f 20   definition,.to 
2430: 64 65 66 69 6e 65 20 61 20 64 65 66 61 75 6c 74  define a default
2440: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65   collating seque
2450: 6e 63 65 20 74 6f 20 61 20 74 61 62 6c 65 20 63  nce to a table c
2460: 6f 6c 75 6d 6e 2c 20 6f 72 20 6f 6e 20 66 69 65  olumn, or on fie
2470: 6c 64 0a 6f 66 20 61 6e 20 69 6e 64 65 78 2c 20  ld.of an index, 
2480: 6f 72 20 69 6e 20 74 68 65 20 4f 52 44 45 52 20  or in the ORDER 
2490: 42 59 20 63 6c 61 75 73 65 20 6f 66 20 61 20 53  BY clause of a S
24a0: 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e  ELECT statement.
24b0: 0a 50 6c 61 6e 6e 65 64 20 65 6e 68 61 6e 63 65  .Planned enhance
24c0: 6d 65 6e 74 73 20 74 6f 20 53 51 4c 69 74 65 20  ments to SQLite 
24d0: 61 72 65 20 74 6f 20 69 6e 63 6c 75 64 65 20 73  are to include s
24e0: 74 61 6e 64 61 72 64 20 43 41 53 54 28 29 20 73  tandard CAST() s
24f0: 79 6e 74 61 78 0a 74 6f 20 61 6c 6c 6f 77 20 74  yntax.to allow t
2500: 68 65 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71  he collating seq
2510: 75 65 6e 63 65 20 6f 66 20 61 6e 20 65 78 70 72  uence of an expr
2520: 65 73 73 69 6f 6e 20 74 6f 20 62 65 20 64 65 66  ession to be def
2530: 69 6e 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e  ined..</p>..<h3>
2540: 36 34 2d 62 69 74 20 52 4f 57 49 44 73 3c 2f 68  64-bit ROWIDs</h
2550: 33 3e 0a 0a 3c 70 3e 0a 45 76 65 72 79 20 72 6f  3>..<p>.Every ro
2560: 77 20 6f 66 20 61 20 74 61 62 6c 65 20 68 61 73  w of a table has
2570: 20 61 20 75 6e 69 71 75 65 20 72 6f 77 69 64 2e   a unique rowid.
2580: 0a 49 66 20 74 68 65 20 74 61 62 6c 65 20 64 65  .If the table de
2590: 66 69 6e 65 73 20 61 20 63 6f 6c 75 6d 6e 20 77  fines a column w
25a0: 69 74 68 20 74 68 65 20 74 79 70 65 20 22 49 4e  ith the type "IN
25b0: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45  TEGER PRIMARY KE
25c0: 59 22 20 74 68 65 6e 20 74 68 61 74 0a 63 6f 6c  Y" then that.col
25d0: 75 6d 6e 20 62 65 63 6f 6d 65 73 20 61 6e 20 61  umn becomes an a
25e0: 6c 69 61 73 20 66 6f 72 20 74 68 65 20 72 6f 77  lias for the row
25f0: 69 64 2e 20 20 42 75 74 20 77 69 74 68 20 6f 72  id.  But with or
2600: 20 77 69 74 68 6f 75 74 20 61 6e 20 49 4e 54 45   without an INTE
2610: 47 45 52 20 50 52 49 4d 41 52 59 0a 4b 45 59 20  GER PRIMARY.KEY 
2620: 63 6f 6c 75 6d 6e 2c 20 65 76 65 72 79 20 72 6f  column, every ro
2630: 77 20 73 74 69 6c 6c 20 68 61 73 20 61 20 72 6f  w still has a ro
2640: 77 69 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 49  wid..</p>..<p>.I
2650: 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  n SQLite version
2660: 20 33 2e 30 2c 20 74 68 65 20 72 6f 77 69 64 20   3.0, the rowid 
2670: 69 73 20 61 20 36 34 2d 62 69 74 20 73 69 67 6e  is a 64-bit sign
2680: 65 64 20 69 6e 74 65 67 65 72 2e 0a 54 68 69 73  ed integer..This
2690: 20 69 73 20 61 6e 20 65 78 70 61 6e 73 69 6f 6e   is an expansion
26a0: 20 6f 66 20 53 51 4c 69 74 65 20 76 65 72 73 69   of SQLite versi
26b0: 6f 6e 20 32 2e 38 20 77 68 69 63 68 20 6f 6e 6c  on 2.8 which onl
26c0: 79 20 70 65 72 6d 69 74 74 65 64 0a 72 6f 77 69  y permitted.rowi
26d0: 64 73 20 6f 66 20 33 32 2d 62 69 74 73 2e 0a 3c  ds of 32-bits..<
26e0: 2f 70 3e 0a 0a 3c 70 3e 0a 54 6f 20 6d 69 6e 69  /p>..<p>.To mini
26f0: 6d 69 7a 65 20 73 74 6f 72 61 67 65 20 73 70 61  mize storage spa
2700: 63 65 2c 20 74 68 65 20 36 34 2d 62 69 74 20 72  ce, the 64-bit r
2710: 6f 77 69 64 20 69 73 20 73 74 6f 72 65 64 20 61  owid is stored a
2720: 73 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 6e  s a variable len
2730: 67 74 68 0a 69 6e 74 65 67 65 72 2e 20 20 52 6f  gth.integer.  Ro
2740: 77 69 64 73 20 62 65 74 77 65 65 6e 20 30 20 61  wids between 0 a
2750: 6e 64 20 31 32 37 20 75 73 65 20 6f 6e 6c 79 20  nd 127 use only 
2760: 61 20 73 69 6e 67 6c 65 20 62 79 74 65 2e 20 20  a single byte.  
2770: 0a 52 6f 77 69 64 73 20 62 65 74 77 65 65 6e 20  .Rowids between 
2780: 30 20 61 6e 64 20 31 36 33 38 33 20 75 73 65 20  0 and 16383 use 
2790: 6a 75 73 74 20 32 20 62 79 74 65 73 2e 20 20 55  just 2 bytes.  U
27a0: 70 20 74 6f 20 32 30 39 37 31 35 32 20 75 73 65  p to 2097152 use
27b0: 73 20 74 68 72 65 65 0a 62 79 74 65 73 2e 20 20  s three.bytes.  
27c0: 41 6e 64 20 73 6f 20 66 6f 72 74 68 2e 20 20 4e  And so forth.  N
27d0: 65 67 61 74 69 76 65 20 72 6f 77 69 64 73 20 61  egative rowids a
27e0: 72 65 20 61 6c 6c 6f 77 65 64 20 62 75 74 20 74  re allowed but t
27f0: 68 65 79 20 61 6c 77 61 79 73 20 75 73 65 0a 6e  hey always use.n
2800: 69 6e 65 20 62 79 74 65 73 20 6f 66 20 73 74 6f  ine bytes of sto
2810: 72 61 67 65 20 61 6e 64 20 73 6f 20 74 68 65 69  rage and so thei
2820: 72 20 75 73 65 20 69 73 20 64 69 73 63 6f 75 72  r use is discour
2830: 61 67 65 64 2e 20 20 57 68 65 6e 20 72 6f 77 69  aged.  When rowi
2840: 64 73 0a 61 72 65 20 67 65 6e 65 72 61 74 65 64  ds.are generated
2850: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62   automatically b
2860: 79 20 53 51 4c 69 74 65 2c 20 74 68 65 79 20 77  y SQLite, they w
2870: 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 6e 6f  ill always be no
2880: 6e 2d 6e 65 67 61 74 69 76 65 2e 0a 3c 2f 70 3e  n-negative..</p>
2890: 0a 0a 3c 68 33 3e 49 6d 70 72 6f 76 65 64 20 43  ..<h3>Improved C
28a0: 6f 6e 63 75 72 72 65 6e 63 79 3c 2f 68 33 3e 0a  oncurrency</h3>.
28b0: 0a 3c 70 3e 0a 53 51 4c 69 74 65 20 76 65 72 73  .<p>.SQLite vers
28c0: 69 6f 6e 20 32 2e 38 20 61 6c 6c 6f 77 65 64 20  ion 2.8 allowed 
28d0: 6d 75 6c 74 69 70 6c 65 20 73 69 6d 75 6c 74 61  multiple simulta
28e0: 6e 65 6f 75 73 20 72 65 61 64 65 72 73 20 6f 72  neous readers or
28f0: 20 61 20 73 69 6e 67 6c 65 0a 77 72 69 74 65 72   a single.writer
2900: 20 62 75 74 20 6e 6f 74 20 62 6f 74 68 2e 20 20   but not both.  
2910: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
2920: 2e 30 20 61 6c 6c 6f 77 73 20 6f 6e 65 20 70 72  .0 allows one pr
2930: 6f 63 65 73 73 20 74 6f 20 62 65 67 69 6e 0a 77  ocess to begin.w
2940: 72 69 74 69 6e 67 20 74 68 65 20 64 61 74 61 62  riting the datab
2950: 61 73 65 20 77 68 69 6c 65 20 6f 74 68 65 72 20  ase while other 
2960: 70 72 6f 63 65 73 73 65 73 20 63 6f 6e 74 69 6e  processes contin
2970: 75 65 20 74 6f 20 72 65 61 64 2e 20 20 54 68 65  ue to read.  The
2980: 0a 77 72 69 74 65 72 20 6d 75 73 74 20 73 74 69  .writer must sti
2990: 6c 6c 20 6f 62 74 61 69 6e 20 61 6e 20 65 78 63  ll obtain an exc
29a0: 6c 75 73 69 76 65 20 6c 6f 63 6b 20 6f 6e 20 74  lusive lock on t
29b0: 68 65 20 64 61 74 61 62 61 73 65 20 66 6f 72 20  he database for 
29c0: 61 20 62 72 69 65 66 0a 69 6e 74 65 72 76 61 6c  a brief.interval
29d0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63 6f 6d   in order to com
29e0: 6d 69 74 20 69 74 73 20 63 68 61 6e 67 65 73 2c  mit its changes,
29f0: 20 62 75 74 20 74 68 65 20 65 78 63 6c 75 73 69   but the exclusi
2a00: 76 65 20 6c 6f 63 6b 20 69 73 20 6e 6f 0a 6c 6f  ve lock is no.lo
2a10: 6e 67 65 72 20 72 65 71 75 69 72 65 64 20 66 6f  nger required fo
2a20: 72 20 74 68 65 20 65 6e 74 69 72 65 20 77 72 69  r the entire wri
2a30: 74 65 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 41 20  te operation..A 
2a40: 3c 61 20 68 72 65 66 3d 22 6c 6f 63 6b 69 6e 67  <a href="locking
2a50: 76 33 2e 68 74 6d 6c 22 3e 6d 6f 72 65 20 64 65  v3.html">more de
2a60: 74 61 69 6c 65 64 20 72 65 70 6f 72 74 3c 2f 61  tailed report</a
2a70: 3e 20 6f 6e 20 74 68 65 20 6c 6f 63 6b 69 6e 67  > on the locking
2a80: 0a 62 65 68 61 76 69 6f 72 20 6f 66 20 53 51 4c  .behavior of SQL
2a90: 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 30 20  ite version 3.0 
2aa0: 69 73 20 61 76 61 69 6c 61 62 6c 65 20 73 65 70  is available sep
2ab0: 61 72 61 74 65 6c 79 2e 0a 3c 2f 70 3e 0a 0a 3c  arately..</p>..<
2ac0: 70 3e 0a 41 20 6c 69 6d 69 74 65 64 20 66 6f 72  p>.A limited for
2ad0: 6d 20 6f 66 20 74 61 62 6c 65 2d 6c 65 76 65 6c  m of table-level
2ae0: 20 6c 6f 63 6b 69 6e 67 20 69 73 20 6e 6f 77 20   locking is now 
2af0: 61 6c 73 6f 20 61 76 61 69 6c 61 62 6c 65 20 69  also available i
2b00: 6e 20 53 51 4c 69 74 65 2e 0a 49 66 20 65 61 63  n SQLite..If eac
2b10: 68 20 74 61 62 6c 65 20 69 73 20 73 74 6f 72 65  h table is store
2b20: 64 20 69 6e 20 61 20 73 65 70 61 72 61 74 65 20  d in a separate 
2b30: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74  database file, t
2b40: 68 6f 73 65 20 73 65 70 61 72 61 74 65 0a 66 69  hose separate.fi
2b50: 6c 65 73 20 63 61 6e 20 62 65 20 61 74 74 61 63  les can be attac
2b60: 68 65 64 20 74 6f 20 74 68 65 20 6d 61 69 6e 20  hed to the main 
2b70: 64 61 74 61 62 61 73 65 20 28 75 73 69 6e 67 20  database (using 
2b80: 74 68 65 20 41 54 54 41 43 48 20 63 6f 6d 6d 61  the ATTACH comma
2b90: 6e 64 29 0a 61 6e 64 20 74 68 65 20 63 6f 6d 62  nd).and the comb
2ba0: 69 6e 65 64 20 64 61 74 61 62 61 73 65 73 20 77  ined databases w
2bb0: 69 6c 6c 20 66 75 6e 63 74 69 6f 6e 20 61 73 20  ill function as 
2bc0: 6f 6e 65 2e 20 20 42 75 74 20 6c 6f 63 6b 73 20  one.  But locks 
2bd0: 77 69 6c 6c 20 6f 6e 6c 79 0a 62 65 20 61 63 71  will only.be acq
2be0: 75 69 72 65 64 20 6f 6e 20 69 6e 64 69 76 69 64  uired on individ
2bf0: 75 61 6c 20 66 69 6c 65 73 20 61 73 20 6e 65 65  ual files as nee
2c00: 64 65 64 2e 20 20 53 6f 20 69 66 20 79 6f 75 20  ded.  So if you 
2c10: 72 65 64 65 66 69 6e 65 20 22 64 61 74 61 62 61  redefine "databa
2c20: 73 65 22 0a 74 6f 20 6d 65 61 6e 20 74 77 6f 20  se".to mean two 
2c30: 6f 72 20 6d 6f 72 65 20 64 61 74 61 62 61 73 65  or more database
2c40: 20 66 69 6c 65 73 2c 20 74 68 65 6e 20 69 74 20   files, then it 
2c50: 69 73 20 65 6e 74 69 72 65 6c 79 20 70 6f 73 73  is entirely poss
2c60: 69 62 6c 65 20 66 6f 72 0a 74 77 6f 20 70 72 6f  ible for.two pro
2c70: 63 65 73 73 65 73 20 74 6f 20 62 65 20 77 72 69  cesses to be wri
2c80: 74 69 6e 67 20 74 6f 20 74 68 65 20 73 61 6d 65  ting to the same
2c90: 20 64 61 74 61 62 61 73 65 20 61 74 20 74 68 65   database at the
2ca0: 20 73 61 6d 65 20 74 69 6d 65 2e 0a 54 6f 20 66   same time..To f
2cb0: 75 72 74 68 65 72 20 73 75 70 70 6f 72 74 20 74  urther support t
2cc0: 68 69 73 20 63 61 70 61 62 69 6c 69 74 79 2c 20  his capability, 
2cd0: 63 6f 6d 6d 69 74 73 20 6f 66 20 74 72 61 6e 73  commits of trans
2ce0: 61 63 74 69 6f 6e 73 20 69 6e 76 6f 6c 76 69 6e  actions involvin
2cf0: 67 0a 74 77 6f 20 6f 72 20 6d 6f 72 65 20 41 54  g.two or more AT
2d00: 54 41 43 48 65 64 20 64 61 74 61 62 61 73 65 20  TACHed database 
2d10: 61 72 65 20 6e 6f 77 20 61 74 6f 6d 69 63 2e 0a  are now atomic..
2d20: 3c 2f 70 3e 0a 0a 3c 68 33 3e 43 72 65 64 69 74  </p>..<h3>Credit
2d30: 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 53 51 4c 69  s</h3>..<p>.SQLi
2d40: 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 30 20 69  te version 3.0 i
2d50: 73 20 6d 61 64 65 20 70 6f 73 73 69 62 6c 65 20  s made possible 
2d60: 69 6e 20 70 61 72 74 20 62 79 20 41 4f 4c 20 64  in part by AOL d
2d70: 65 76 65 6c 6f 70 65 72 73 0a 73 75 70 70 6f 72  evelopers.suppor
2d80: 74 69 6e 67 20 61 6e 64 20 65 6d 62 72 61 63 69  ting and embraci
2d90: 6e 67 20 67 72 65 61 74 20 4f 70 65 6e 2d 53 6f  ng great Open-So
2da0: 75 72 63 65 20 53 6f 66 74 77 61 72 65 2e 0a 3c  urce Software..<
2db0: 2f 70 3e 0a 0a 0a 7d 0a 66 6f 6f 74 65 72 20 7b  /p>...}.footer {
2dc0: 24 49 64 3a 20 76 65 72 73 69 6f 6e 33 2e 74 63  $Id: version3.tc
2dd0: 6c 2c 76 20 31 2e 36 20 32 30 30 36 2f 30 33 2f  l,v 1.6 2006/03/
2de0: 30 33 20 32 31 3a 33 39 3a 35 34 20 64 72 68 20  03 21:39:54 drh 
2df0: 45 78 70 20 24 7d 0a                             Exp $}.