Documentation Source Text

Hex Artifact Content
Login

Artifact 8d13e1d71223bd8d39ebc658438609b3e5191c7e:


0000: 3c 74 69 74 6c 65 3e 53 51 4c 69 74 65 20 56 65  <title>SQLite Ve
0010: 72 73 69 6f 6e 20 33 20 4f 76 65 72 76 69 65 77  rsion 3 Overview
0020: 3c 2f 74 69 74 6c 65 3e 0a 0a 3c 68 32 3e 53 51  </title>..<h2>SQ
0030: 4c 69 74 65 20 56 65 72 73 69 6f 6e 20 33 20 4f  Lite Version 3 O
0040: 76 65 72 76 69 65 77 3c 2f 68 32 3e 0a 0a 3c 70  verview</h2>..<p
0050: 3e 0a 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  >.SQLite version
0060: 20 33 2e 30 20 69 6e 74 72 6f 64 75 63 65 73 20   3.0 introduces 
0070: 69 6d 70 6f 72 74 61 6e 74 20 63 68 61 6e 67 65  important change
0080: 73 20 74 6f 20 74 68 65 20 6c 69 62 72 61 72 79  s to the library
0090: 2c 20 69 6e 63 6c 75 64 69 6e 67 3a 0a 3c 2f 70  , including:.</p
00a0: 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 41 20 6d 6f  >..<ul>.<li>A mo
00b0: 72 65 20 63 6f 6d 70 61 63 74 20 66 6f 72 6d 61  re compact forma
00c0: 74 20 66 6f 72 20 64 61 74 61 62 61 73 65 20 66  t for database f
00d0: 69 6c 65 73 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 4d  iles.</li>.<li>M
00e0: 61 6e 69 66 65 73 74 20 74 79 70 69 6e 67 20 61  anifest typing a
00f0: 6e 64 20 42 4c 4f 42 20 73 75 70 70 6f 72 74 2e  nd BLOB support.
0100: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 53 75 70 70 6f 72  </li>.<li>Suppor
0110: 74 20 66 6f 72 20 62 6f 74 68 20 55 54 46 2d 38  t for both UTF-8
0120: 20 61 6e 64 20 55 54 46 2d 31 36 20 74 65 78 74   and UTF-16 text
0130: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 72 2d  .</li>.<li>User-
0140: 64 65 66 69 6e 65 64 20 74 65 78 74 20 63 6f 6c  defined text col
0150: 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73  lating sequences
0160: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 36 34 2d 62 69  .</li>.<li>64-bi
0170: 74 20 52 4f 57 49 44 73 2e 3c 2f 6c 69 3e 0a 3c  t ROWIDs.</li>.<
0180: 6c 69 3e 49 6d 70 72 6f 76 65 64 20 43 6f 6e 63  li>Improved Conc
0190: 75 72 72 65 6e 63 79 2e 3c 2f 6c 69 3e 0a 3c 2f  urrency.</li>.</
01a0: 75 6c 3e 0a 0a 3c 70 3e 0a 54 68 69 73 20 64 6f  ul>..<p>.This do
01b0: 63 75 6d 65 6e 74 20 69 73 20 61 20 71 75 69 63  cument is a quic
01c0: 6b 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74  k introduction t
01d0: 6f 20 74 68 65 20 63 68 61 6e 67 65 73 20 66 6f  o the changes fo
01e0: 72 20 53 51 4c 69 74 65 20 33 2e 30 0a 66 6f 72  r SQLite 3.0.for
01f0: 20 75 73 65 72 73 20 77 68 6f 20 61 72 65 20 61   users who are a
0200: 6c 72 65 61 64 79 20 66 61 6d 69 6c 69 61 72 20  lready familiar 
0210: 77 69 74 68 20 53 51 4c 69 74 65 20 76 65 72 73  with SQLite vers
0220: 69 6f 6e 20 32 2e 38 2e 0a 3c 2f 70 3e 0a 0a 3c  ion 2.8..</p>..<
0230: 68 33 3e 4e 61 6d 69 6e 67 20 43 68 61 6e 67 65  h3>Naming Change
0240: 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 53 51 4c 69  s</h3>..<p>.SQLi
0250: 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 20 77  te version 2.8 w
0260: 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20  ill continue to 
0270: 62 65 20 73 75 70 70 6f 72 74 65 64 20 77 69 74  be supported wit
0280: 68 20 62 75 67 20 66 69 78 65 73 0a 66 6f 72 20  h bug fixes.for 
0290: 74 68 65 20 66 6f 72 65 73 65 65 61 62 6c 65 20  the foreseeable 
02a0: 66 75 74 75 72 65 2e 20 20 49 6e 20 6f 72 64 65  future.  In orde
02b0: 72 20 74 6f 20 61 6c 6c 6f 77 20 53 51 4c 69 74  r to allow SQLit
02c0: 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 0a 61 6e  e version 2.8.an
02d0: 64 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  d SQLite version
02e0: 20 33 2e 30 20 74 6f 20 70 65 61 63 65 66 75 6c   3.0 to peaceful
02f0: 6c 79 20 63 6f 65 78 69 73 74 2c 20 74 68 65 20  ly coexist, the 
0300: 6e 61 6d 65 73 20 6f 66 20 6b 65 79 20 66 69 6c  names of key fil
0310: 65 73 0a 61 6e 64 20 41 50 49 73 20 69 6e 20 53  es.and APIs in S
0320: 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e  QLite version 3.
0330: 30 20 68 61 76 65 20 62 65 65 6e 20 63 68 61 6e  0 have been chan
0340: 67 65 64 20 74 6f 20 69 6e 63 6c 75 64 65 20 74  ged to include t
0350: 68 65 0a 63 68 61 72 61 63 74 65 72 20 22 33 22  he.character "3"
0360: 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20  .  For example, 
0370: 74 68 65 20 69 6e 63 6c 75 64 65 20 66 69 6c 65  the include file
0380: 20 75 73 65 64 20 62 79 20 43 20 70 72 6f 67 72   used by C progr
0390: 61 6d 73 0a 68 61 73 20 62 65 65 6e 20 63 68 61  ams.has been cha
03a0: 6e 67 65 64 20 66 72 6f 6d 20 22 73 71 6c 69 74  nged from "sqlit
03b0: 65 2e 68 22 20 74 6f 20 22 73 71 6c 69 74 65 33  e.h" to "sqlite3
03c0: 2e 68 22 2e 20 20 41 6e 64 20 74 68 65 20 6e 61  .h".  And the na
03d0: 6d 65 20 6f 66 0a 74 68 65 20 73 68 65 6c 6c 20  me of.the shell 
03e0: 70 72 6f 67 72 61 6d 20 75 73 65 64 20 74 6f 20  program used to 
03f0: 69 6e 74 65 72 61 63 74 20 77 69 74 68 20 64 61  interact with da
0400: 74 61 62 61 73 65 73 20 68 61 73 20 62 65 65 6e  tabases has been
0410: 20 63 68 61 6e 67 65 64 0a 66 72 6f 6d 20 22 73   changed.from "s
0420: 71 6c 69 74 65 2e 65 78 65 22 20 74 6f 20 22 73  qlite.exe" to "s
0430: 71 6c 69 74 65 33 2e 65 78 65 22 2e 20 20 57 69  qlite3.exe".  Wi
0440: 74 68 20 74 68 65 73 65 20 63 68 61 6e 67 65 73  th these changes
0450: 2c 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65  , it is possible
0460: 0a 74 6f 20 68 61 76 65 20 62 6f 74 68 20 53 51  .to have both SQ
0470: 4c 69 74 65 20 32 2e 38 20 61 6e 64 20 53 51 4c  Lite 2.8 and SQL
0480: 69 74 65 20 33 2e 30 20 69 6e 73 74 61 6c 6c 65  ite 3.0 installe
0490: 64 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 73 79  d on the same sy
04a0: 73 74 65 6d 20 61 74 0a 74 68 65 20 73 61 6d 65  stem at.the same
04b0: 20 74 69 6d 65 2e 20 20 41 6e 64 20 69 74 20 69   time.  And it i
04c0: 73 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 74  s possible for t
04d0: 68 65 20 73 61 6d 65 20 43 20 70 72 6f 67 72 61  he same C progra
04e0: 6d 20 74 6f 20 6c 69 6e 6b 0a 61 67 61 69 6e 73  m to link.agains
04f0: 74 20 62 6f 74 68 20 53 51 4c 69 74 65 20 32 2e  t both SQLite 2.
0500: 38 20 61 6e 64 20 53 51 4c 69 74 65 20 33 2e 30  8 and SQLite 3.0
0510: 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d   at the same tim
0520: 65 20 61 6e 64 20 74 6f 20 75 73 65 0a 62 6f 74  e and to use.bot
0530: 68 20 6c 69 62 72 61 72 69 65 73 20 61 74 20 74  h libraries at t
0540: 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 3c 2f  he same time..</
0550: 70 3e 0a 0a 3c 68 33 3e 4e 65 77 20 46 69 6c 65  p>..<h3>New File
0560: 20 46 6f 72 6d 61 74 3c 2f 68 33 3e 0a 0a 3c 70   Format</h3>..<p
0570: 3e 0a 54 68 65 20 66 6f 72 6d 61 74 20 75 73 65  >.The format use
0580: 64 20 62 79 20 53 51 4c 69 74 65 20 64 61 74 61  d by SQLite data
0590: 62 61 73 65 20 66 69 6c 65 73 20 68 61 73 20 62  base files has b
05a0: 65 65 6e 20 63 6f 6d 70 6c 65 74 65 6c 79 20 72  een completely r
05b0: 65 76 69 73 65 64 2e 0a 54 68 65 20 6f 6c 64 20  evised..The old 
05c0: 76 65 72 73 69 6f 6e 20 32 2e 31 20 66 6f 72 6d  version 2.1 form
05d0: 61 74 20 61 6e 64 20 74 68 65 20 6e 65 77 20 33  at and the new 3
05e0: 2e 30 20 66 6f 72 6d 61 74 20 61 72 65 20 69 6e  .0 format are in
05f0: 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 0a  compatible with.
0600: 6f 6e 65 20 61 6e 6f 74 68 65 72 2e 20 20 56 65  one another.  Ve
0610: 72 73 69 6f 6e 20 32 2e 38 20 6f 66 20 53 51 4c  rsion 2.8 of SQL
0620: 69 74 65 20 77 69 6c 6c 20 6e 6f 74 20 72 65 61  ite will not rea
0630: 64 20 61 20 76 65 72 73 69 6f 6e 20 33 2e 30 20  d a version 3.0 
0640: 64 61 74 61 62 61 73 65 0a 66 69 6c 65 73 20 61  database.files a
0650: 6e 64 20 76 65 72 73 69 6f 6e 20 33 2e 30 20 6f  nd version 3.0 o
0660: 66 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f  f SQLite will no
0670: 74 20 72 65 61 64 20 61 20 76 65 72 73 69 6f 6e  t read a version
0680: 20 32 2e 38 20 64 61 74 61 62 61 73 65 20 66 69   2.8 database fi
0690: 6c 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 6f  le..</p>..<p>.To
06a0: 20 63 6f 6e 76 65 72 74 20 61 6e 20 53 51 4c 69   convert an SQLi
06b0: 74 65 20 32 2e 38 20 64 61 74 61 62 61 73 65 20  te 2.8 database 
06c0: 69 6e 74 6f 20 61 6e 20 53 51 4c 69 74 65 20 33  into an SQLite 3
06d0: 2e 30 20 64 61 74 61 62 61 73 65 2c 20 68 61 76  .0 database, hav
06e0: 65 0a 72 65 61 64 79 20 74 68 65 20 63 6f 6d 6d  e.ready the comm
06f0: 61 6e 64 2d 6c 69 6e 65 20 73 68 65 6c 6c 73 20  and-line shells 
0700: 66 6f 72 20 62 6f 74 68 20 76 65 72 73 69 6f 6e  for both version
0710: 20 32 2e 38 20 61 6e 64 20 33 2e 30 2e 20 20 54   2.8 and 3.0.  T
0720: 68 65 6e 0a 65 6e 74 65 72 20 61 20 63 6f 6d 6d  hen.enter a comm
0730: 61 6e 64 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c  and like the fol
0740: 6c 6f 77 69 6e 67 3a 0a 3c 2f 70 3e 0a 0a 3c 62  lowing:.</p>..<b
0750: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a  lockquote><pre>.
0760: 73 71 6c 69 74 65 20 4f 4c 44 2e 44 42 20 2e 64  sqlite OLD.DB .d
0770: 75 6d 70 20 7c 20 73 71 6c 69 74 65 33 20 4e 45  ump | sqlite3 NE
0780: 57 2e 44 42 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  W.DB.</pre></blo
0790: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68  ckquote>..<p>.Th
07a0: 65 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 66  e new database f
07b0: 69 6c 65 20 66 6f 72 6d 61 74 20 75 73 65 73 20  ile format uses 
07c0: 42 2b 74 72 65 65 73 20 66 6f 72 20 74 61 62 6c  B+trees for tabl
07d0: 65 73 2e 20 20 49 6e 20 61 20 42 2b 74 72 65 65  es.  In a B+tree
07e0: 2c 20 61 6c 6c 0a 64 61 74 61 20 69 73 20 73 74  , all.data is st
07f0: 6f 72 65 64 20 69 6e 20 74 68 65 20 6c 65 61 76  ored in the leav
0800: 65 73 20 6f 66 20 74 68 65 20 74 72 65 65 20 69  es of the tree i
0810: 6e 73 74 65 61 64 20 6f 66 20 69 6e 20 62 6f 74  nstead of in bot
0820: 68 20 74 68 65 20 6c 65 61 76 65 73 20 61 6e 64  h the leaves and
0830: 0a 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74  .the intermediat
0840: 65 20 62 72 61 6e 63 68 20 6e 6f 64 65 73 2e 20  e branch nodes. 
0850: 20 54 68 65 20 75 73 65 20 6f 66 20 42 2b 74 72   The use of B+tr
0860: 65 65 73 20 66 6f 72 20 74 61 62 6c 65 73 20 61  ees for tables a
0870: 6c 6c 6f 77 73 20 66 6f 72 0a 62 65 74 74 65 72  llows for.better
0880: 20 73 63 61 6c 61 62 69 6c 69 74 79 20 61 6e 64   scalability and
0890: 20 74 68 65 20 73 74 6f 72 61 67 65 20 6f 66 20   the storage of 
08a0: 6c 61 72 67 65 72 20 64 61 74 61 20 66 69 65 6c  larger data fiel
08b0: 64 73 20 77 69 74 68 6f 75 74 20 74 68 65 20 75  ds without the u
08c0: 73 65 20 6f 66 0a 6f 76 65 72 66 6c 6f 77 20 70  se of.overflow p
08d0: 61 67 65 73 2e 20 20 54 72 61 64 69 74 69 6f 6e  ages.  Tradition
08e0: 61 6c 20 42 2d 74 72 65 65 73 20 61 72 65 20 73  al B-trees are s
08f0: 74 69 6c 6c 20 75 73 65 64 20 66 6f 72 20 69 6e  till used for in
0900: 64 69 63 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a  dices.</p>..<p>.
0910: 54 68 65 20 6e 65 77 20 66 69 6c 65 20 66 6f 72  The new file for
0920: 6d 61 74 20 61 6c 73 6f 20 73 75 70 70 6f 72 74  mat also support
0930: 73 20 76 61 72 69 61 62 6c 65 20 70 61 67 65 73  s variable pages
0940: 20 73 69 7a 65 73 20 62 65 74 77 65 65 6e 20 35   sizes between 5
0950: 31 32 20 61 6e 64 0a 36 35 35 33 36 20 62 79 74  12 and.65536 byt
0960: 65 73 2e 20 20 54 68 65 20 73 69 7a 65 20 6f 66  es.  The size of
0970: 20 61 20 70 61 67 65 20 69 73 20 73 74 6f 72 65   a page is store
0980: 64 20 69 6e 20 74 68 65 20 66 69 6c 65 20 68 65  d in the file he
0990: 61 64 65 72 20 73 6f 20 74 68 65 0a 73 61 6d 65  ader so the.same
09a0: 20 6c 69 62 72 61 72 79 20 63 61 6e 20 72 65 61   library can rea
09b0: 64 20 64 61 74 61 62 61 73 65 73 20 77 69 74 68  d databases with
09c0: 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 65 73   different pages
09d0: 20 73 69 7a 65 73 2c 20 69 6e 20 74 68 65 6f 72   sizes, in theor
09e0: 79 2c 0a 74 68 6f 75 67 68 20 74 68 69 73 20 66  y,.though this f
09f0: 65 61 74 75 72 65 20 68 61 73 20 6e 6f 74 20 79  eature has not y
0a00: 65 74 20 62 65 65 6e 20 69 6d 70 6c 65 6d 65 6e  et been implemen
0a10: 74 65 64 20 69 6e 20 70 72 61 63 74 69 63 65 2e  ted in practice.
0a20: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 6e  .</p>..<p>.The n
0a30: 65 77 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 6f  ew file format o
0a40: 6d 69 74 73 20 75 6e 75 73 65 64 20 66 69 65 6c  mits unused fiel
0a50: 64 73 20 66 72 6f 6d 20 69 74 73 20 64 69 73 6b  ds from its disk
0a60: 20 69 6d 61 67 65 73 2e 20 20 46 6f 72 20 65 78   images.  For ex
0a70: 61 6d 70 6c 65 2c 0a 69 6e 64 69 63 65 73 20 75  ample,.indices u
0a80: 73 65 20 6f 6e 6c 79 20 74 68 65 20 6b 65 79 20  se only the key 
0a90: 70 61 72 74 20 6f 66 20 61 20 42 2d 74 72 65 65  part of a B-tree
0aa0: 20 72 65 63 6f 72 64 20 61 6e 64 20 6e 6f 74 20   record and not 
0ab0: 74 68 65 20 64 61 74 61 2e 20 20 53 6f 0a 66 6f  the data.  So.fo
0ac0: 72 20 69 6e 64 69 63 65 73 2c 20 74 68 65 20 66  r indices, the f
0ad0: 69 65 6c 64 20 74 68 61 74 20 72 65 63 6f 72 64  ield that record
0ae0: 73 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 20  s the length of 
0af0: 74 68 65 20 64 61 74 61 20 69 73 20 6f 6d 69 74  the data is omit
0b00: 74 65 64 2e 0a 49 6e 74 65 67 65 72 20 76 61 6c  ted..Integer val
0b10: 75 65 73 20 73 75 63 68 20 61 73 20 74 68 65 20  ues such as the 
0b20: 6c 65 6e 67 74 68 20 6f 66 20 6b 65 79 20 61 6e  length of key an
0b30: 64 20 64 61 74 61 20 61 72 65 20 73 74 6f 72 65  d data are store
0b40: 64 20 75 73 69 6e 67 0a 61 20 76 61 72 69 61 62  d using.a variab
0b50: 6c 65 2d 6c 65 6e 67 74 68 20 65 6e 63 6f 64 69  le-length encodi
0b60: 6e 67 20 73 6f 20 74 68 61 74 20 6f 6e 6c 79 20  ng so that only 
0b70: 6f 6e 65 20 6f 72 20 74 77 6f 20 62 79 74 65 73  one or two bytes
0b80: 20 61 72 65 20 72 65 71 75 69 72 65 64 20 74 6f   are required to
0b90: 0a 73 74 6f 72 65 20 74 68 65 20 6d 6f 73 74 20  .store the most 
0ba0: 63 6f 6d 6d 6f 6e 20 63 61 73 65 73 20 62 75 74  common cases but
0bb0: 20 75 70 20 74 6f 20 36 34 2d 62 69 74 73 20 6f   up to 64-bits o
0bc0: 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61  f information ca
0bd0: 6e 20 62 65 20 65 6e 63 6f 64 65 64 0a 69 66 20  n be encoded.if 
0be0: 6e 65 65 64 65 64 2e 20 0a 49 6e 74 65 67 65 72  needed. .Integer
0bf0: 20 61 6e 64 20 66 6c 6f 61 74 69 6e 67 20 70 6f   and floating po
0c00: 69 6e 74 20 64 61 74 61 20 69 73 20 73 74 6f 72  int data is stor
0c10: 65 64 20 6f 6e 20 74 68 65 20 64 69 73 6b 20 69  ed on the disk i
0c20: 6e 20 62 69 6e 61 72 79 20 72 61 74 68 65 72 0a  n binary rather.
0c30: 74 68 61 6e 20 62 65 69 6e 67 20 63 6f 6e 76 65  than being conve
0c40: 72 74 65 64 20 69 6e 74 6f 20 41 53 43 49 49 20  rted into ASCII 
0c50: 61 73 20 69 6e 20 53 51 4c 69 74 65 20 76 65 72  as in SQLite ver
0c60: 73 69 6f 6e 20 32 2e 38 2e 0a 54 68 65 73 65 20  sion 2.8..These 
0c70: 63 68 61 6e 67 65 73 20 74 61 6b 65 6e 20 74 6f  changes taken to
0c80: 67 65 74 68 65 72 20 72 65 73 75 6c 74 20 69 6e  gether result in
0c90: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20   database files 
0ca0: 74 68 61 74 20 61 72 65 20 74 79 70 69 63 61 6c  that are typical
0cb0: 6c 79 0a 32 35 25 20 74 6f 20 33 35 25 20 73 6d  ly.25% to 35% sm
0cc0: 61 6c 6c 65 72 20 74 68 61 6e 20 74 68 65 20 65  aller than the e
0cd0: 71 75 69 76 61 6c 65 6e 74 20 66 69 6c 65 73 20  quivalent files 
0ce0: 69 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f  in SQLite versio
0cf0: 6e 20 32 2e 38 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e  n 2.8..</p>..<p>
0d00: 0a 44 65 74 61 69 6c 73 20 6f 66 20 74 68 65 20  .Details of the 
0d10: 6c 6f 77 2d 6c 65 76 65 6c 20 42 2d 74 72 65 65  low-level B-tree
0d20: 20 66 6f 72 6d 61 74 20 75 73 65 64 20 69 6e 20   format used in 
0d30: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
0d40: 2e 30 20 63 61 6e 0a 62 65 20 66 6f 75 6e 64 20  .0 can.be found 
0d50: 69 6e 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e  in header commen
0d60: 74 73 20 74 6f 20 74 68 65 20 0a 3c 61 20 68 72  ts to the .<a hr
0d70: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73  ef="http://www.s
0d80: 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 66 69  qlite.org/src/fi
0d90: 6e 66 6f 3f 6e 61 6d 65 3d 73 72 63 2f 62 74 72  nfo?name=src/btr
0da0: 65 65 49 6e 74 2e 68 22 3e 62 74 72 65 65 49 6e  eeInt.h">btreeIn
0db0: 74 2e 68 3c 2f 61 3e 0a 73 6f 75 72 63 65 20 66  t.h</a>.source f
0dc0: 69 6c 65 20 61 6e 64 20 69 6e 20 74 68 65 20 5b  ile and in the [
0dd0: 66 69 6c 65 20 66 6f 72 6d 61 74 5d 20 64 6f 63  file format] doc
0de0: 75 6d 65 6e 74 61 74 69 6f 6e 2e 0a 3c 2f 70 3e  umentation..</p>
0df0: 0a 0a 3c 68 33 3e 4d 61 6e 69 66 65 73 74 20 54  ..<h3>Manifest T
0e00: 79 70 69 6e 67 20 61 6e 64 20 42 4c 4f 42 20 53  yping and BLOB S
0e10: 75 70 70 6f 72 74 3c 2f 68 33 3e 0a 0a 3c 70 3e  upport</h3>..<p>
0e20: 0a 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20  .SQLite version 
0e30: 32 2e 38 20 77 69 6c 6c 20 64 65 61 6c 20 77 69  2.8 will deal wi
0e40: 74 68 20 64 61 74 61 20 69 6e 20 76 61 72 69 6f  th data in vario
0e50: 75 73 20 66 6f 72 6d 61 74 73 20 69 6e 74 65 72  us formats inter
0e60: 6e 61 6c 6c 79 2c 0a 62 75 74 20 77 68 65 6e 20  nally,.but when 
0e70: 77 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64  writing to the d
0e80: 69 73 6b 20 6f 72 20 69 6e 74 65 72 61 63 74 69  isk or interacti
0e90: 6e 67 20 74 68 72 6f 75 67 68 20 69 74 73 20 41  ng through its A
0ea0: 50 49 2c 20 53 51 4c 69 74 65 20 32 2e 38 0a 61  PI, SQLite 2.8.a
0eb0: 6c 77 61 79 73 20 63 6f 6e 76 65 72 74 73 20 64  lways converts d
0ec0: 61 74 61 20 69 6e 74 6f 20 41 53 43 49 49 20 74  ata into ASCII t
0ed0: 65 78 74 2e 20 20 53 51 4c 69 74 65 20 33 2e 30  ext.  SQLite 3.0
0ee0: 2c 20 69 6e 20 63 6f 6e 74 72 61 73 74 2c 20 65  , in contrast, e
0ef0: 78 70 6f 73 65 73 20 0a 69 74 73 20 69 6e 74 65  xposes .its inte
0f00: 72 6e 61 6c 20 64 61 74 61 20 72 65 70 72 65 73  rnal data repres
0f10: 65 6e 74 61 74 69 6f 6e 73 20 74 6f 20 74 68 65  entations to the
0f20: 20 75 73 65 72 20 61 6e 64 20 73 74 6f 72 65 73   user and stores
0f30: 20 62 69 6e 61 72 79 20 72 65 70 72 65 73 65 6e   binary represen
0f40: 74 61 74 69 6f 6e 73 0a 74 6f 20 64 69 73 6b 20  tations.to disk 
0f50: 77 68 65 6e 20 61 70 70 72 6f 70 72 69 61 74 65  when appropriate
0f60: 2e 20 20 54 68 65 20 65 78 70 6f 73 69 6e 67 20  .  The exposing 
0f70: 6f 66 20 6e 6f 6e 2d 41 53 43 49 49 20 72 65 70  of non-ASCII rep
0f80: 72 65 73 65 6e 74 61 74 69 6f 6e 73 20 77 61 73  resentations was
0f90: 0a 61 64 64 65 64 20 69 6e 20 6f 72 64 65 72 20  .added in order 
0fa0: 74 6f 20 73 75 70 70 6f 72 74 20 42 4c 4f 42 73  to support BLOBs
0fb0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 51 4c 69  ..</p>..<p>.SQLi
0fc0: 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 20 68  te version 2.8 h
0fd0: 61 64 20 74 68 65 20 66 65 61 74 75 72 65 20 74  ad the feature t
0fe0: 68 61 74 20 61 6e 79 20 74 79 70 65 20 6f 66 20  hat any type of 
0ff0: 64 61 74 61 20 63 6f 75 6c 64 20 62 65 20 73 74  data could be st
1000: 6f 72 65 64 0a 69 6e 20 61 6e 79 20 74 61 62 6c  ored.in any tabl
1010: 65 20 63 6f 6c 75 6d 6e 20 72 65 67 61 72 64 6c  e column regardl
1020: 65 73 73 20 6f 66 20 74 68 65 20 64 65 63 6c 61  ess of the decla
1030: 72 65 64 20 74 79 70 65 20 6f 66 20 74 68 61 74  red type of that
1040: 20 63 6f 6c 75 6d 6e 2e 20 20 54 68 69 73 0a 66   column.  This.f
1050: 65 61 74 75 72 65 20 69 73 20 72 65 74 61 69 6e  eature is retain
1060: 65 64 20 69 6e 20 76 65 72 73 69 6f 6e 20 33 2e  ed in version 3.
1070: 30 2c 20 74 68 6f 75 67 68 20 69 6e 20 61 20 73  0, though in a s
1080: 6c 69 67 68 74 6c 79 20 6d 6f 64 69 66 69 65 64  lightly modified
1090: 20 66 6f 72 6d 2e 0a 45 61 63 68 20 74 61 62 6c   form..Each tabl
10a0: 65 20 63 6f 6c 75 6d 6e 20 77 69 6c 6c 20 73 74  e column will st
10b0: 6f 72 65 20 61 6e 79 20 74 79 70 65 20 6f 66 20  ore any type of 
10c0: 64 61 74 61 2c 20 74 68 6f 75 67 68 20 63 6f 6c  data, though col
10d0: 75 6d 6e 73 20 68 61 76 65 20 61 6e 0a 61 66 66  umns have an.aff
10e0: 69 6e 69 74 79 20 66 6f 72 20 74 68 65 20 66 6f  inity for the fo
10f0: 72 6d 61 74 20 6f 66 20 64 61 74 61 20 64 65 66  rmat of data def
1100: 69 6e 65 64 20 62 79 20 74 68 65 69 72 20 64 65  ined by their de
1110: 63 6c 61 72 65 64 20 64 61 74 61 74 79 70 65 2e  clared datatype.
1120: 0a 57 68 65 6e 20 64 61 74 61 20 69 73 20 69 6e  .When data is in
1130: 73 65 72 74 65 64 20 69 6e 74 6f 20 61 20 63 6f  serted into a co
1140: 6c 75 6d 6e 2c 20 74 68 61 74 20 63 6f 6c 75 6d  lumn, that colum
1150: 6e 20 77 69 6c 6c 20 6d 61 6b 65 20 61 6e 20 61  n will make an a
1160: 74 74 65 6d 70 74 0a 74 6f 20 63 6f 6e 76 65 72  ttempt.to conver
1170: 74 20 74 68 65 20 64 61 74 61 20 66 6f 72 6d 61  t the data forma
1180: 74 20 69 6e 74 6f 20 74 68 65 20 63 6f 6c 75 6d  t into the colum
1190: 6e 27 73 20 64 65 63 6c 61 72 65 64 20 74 79 70  n's declared typ
11a0: 65 2e 20 20 20 41 6c 6c 20 53 51 4c 0a 64 61 74  e.   All SQL.dat
11b0: 61 62 61 73 65 20 65 6e 67 69 6e 65 73 20 64 6f  abase engines do
11c0: 20 74 68 69 73 2e 20 20 54 68 65 20 64 69 66 66   this.  The diff
11d0: 65 72 65 6e 63 65 20 69 73 20 74 68 61 74 20 53  erence is that S
11e0: 51 4c 69 74 65 20 33 2e 30 20 77 69 6c 6c 20 0a  QLite 3.0 will .
11f0: 73 74 69 6c 6c 20 73 74 6f 72 65 20 74 68 65 20  still store the 
1200: 64 61 74 61 20 65 76 65 6e 20 69 66 20 61 20 66  data even if a f
1210: 6f 72 6d 61 74 20 63 6f 6e 76 65 72 73 69 6f 6e  ormat conversion
1220: 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65   is not possible
1230: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 46 6f 72 20  ..</p>..<p>.For 
1240: 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20  example, if you 
1250: 68 61 76 65 20 61 20 74 61 62 6c 65 20 63 6f 6c  have a table col
1260: 75 6d 6e 20 64 65 63 6c 61 72 65 64 20 74 6f 20  umn declared to 
1270: 62 65 20 6f 66 20 74 79 70 65 20 22 49 4e 54 45  be of type "INTE
1280: 47 45 52 22 0a 61 6e 64 20 79 6f 75 20 74 72 79  GER".and you try
1290: 20 74 6f 20 69 6e 73 65 72 74 20 61 20 73 74 72   to insert a str
12a0: 69 6e 67 2c 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ing, the column 
12b0: 77 69 6c 6c 20 6c 6f 6f 6b 20 61 74 20 74 68 65  will look at the
12c0: 20 74 65 78 74 20 73 74 72 69 6e 67 0a 61 6e 64   text string.and
12d0: 20 73 65 65 20 69 66 20 69 74 20 6c 6f 6f 6b 73   see if it looks
12e0: 20 6c 69 6b 65 20 61 20 6e 75 6d 62 65 72 2e 20   like a number. 
12f0: 20 49 66 20 74 68 65 20 73 74 72 69 6e 67 20 64   If the string d
1300: 6f 65 73 20 6c 6f 6f 6b 20 6c 69 6b 65 20 61 20  oes look like a 
1310: 6e 75 6d 62 65 72 0a 69 74 20 69 73 20 63 6f 6e  number.it is con
1320: 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 6e 75  verted into a nu
1330: 6d 62 65 72 20 61 6e 64 20 69 6e 74 6f 20 61 6e  mber and into an
1340: 20 69 6e 74 65 67 65 72 20 69 66 20 74 68 65 20   integer if the 
1350: 6e 75 6d 62 65 72 20 64 6f 65 73 20 6e 6f 74 0a  number does not.
1360: 68 61 76 65 20 61 20 66 72 61 63 74 69 6f 6e 61  have a fractiona
1370: 6c 20 70 61 72 74 2c 20 61 6e 64 20 73 74 6f 72  l part, and stor
1380: 65 64 20 74 68 61 74 20 77 61 79 2e 20 20 42 75  ed that way.  Bu
1390: 74 20 69 66 20 74 68 65 20 73 74 72 69 6e 67 20  t if the string 
13a0: 69 73 20 6e 6f 74 0a 61 20 77 65 6c 6c 2d 66 6f  is not.a well-fo
13b0: 72 6d 65 64 20 6e 75 6d 62 65 72 20 69 74 20 69  rmed number it i
13c0: 73 20 73 74 69 6c 6c 20 73 74 6f 72 65 64 20 61  s still stored a
13d0: 73 20 61 20 73 74 72 69 6e 67 2e 20 20 41 20 63  s a string.  A c
13e0: 6f 6c 75 6d 6e 20 77 69 74 68 20 61 0a 74 79 70  olumn with a.typ
13f0: 65 20 6f 66 20 22 54 45 58 54 22 20 74 72 69 65  e of "TEXT" trie
1400: 73 20 74 6f 20 63 6f 6e 76 65 72 74 20 6e 75 6d  s to convert num
1410: 62 65 72 73 20 69 6e 74 6f 20 61 6e 20 41 53 43  bers into an ASC
1420: 49 49 2d 54 65 78 74 20 72 65 70 72 65 73 65 6e  II-Text represen
1430: 74 61 74 69 6f 6e 0a 62 65 66 6f 72 65 20 73 74  tation.before st
1440: 6f 72 69 6e 67 20 74 68 65 6d 2e 20 20 42 75 74  oring them.  But
1450: 20 42 4c 4f 42 73 20 61 72 65 20 73 74 6f 72 65   BLOBs are store
1460: 64 20 69 6e 20 54 45 58 54 20 63 6f 6c 75 6d 6e  d in TEXT column
1470: 73 20 61 73 20 42 4c 4f 42 73 20 62 65 63 61 75  s as BLOBs becau
1480: 73 65 0a 79 6f 75 20 63 61 6e 6e 6f 74 20 69 6e  se.you cannot in
1490: 20 67 65 6e 65 72 61 6c 20 63 6f 6e 76 65 72 74   general convert
14a0: 20 61 20 42 4c 4f 42 20 69 6e 74 6f 20 74 65 78   a BLOB into tex
14b0: 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 49 6e 20  t..</p>..<p>.In 
14c0: 6d 6f 73 74 20 6f 74 68 65 72 20 53 51 4c 20 64  most other SQL d
14d0: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 73 20  atabase engines 
14e0: 74 68 65 20 64 61 74 61 74 79 70 65 20 69 73 20  the datatype is 
14f0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 0a  associated with.
1500: 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e  the table column
1510: 20 74 68 61 74 20 68 6f 6c 64 73 20 74 68 65 20   that holds the 
1520: 64 61 74 61 20 2d 20 77 69 74 68 20 74 68 65 20  data - with the 
1530: 64 61 74 61 20 63 6f 6e 74 61 69 6e 65 72 2e 0a  data container..
1540: 49 6e 20 53 51 4c 69 74 65 20 33 2e 30 2c 20 74  In SQLite 3.0, t
1550: 68 65 20 64 61 74 61 74 79 70 65 20 69 73 20 61  he datatype is a
1560: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74  ssociated with t
1570: 68 65 20 64 61 74 61 20 69 74 73 65 6c 66 2c 20  he data itself, 
1580: 6e 6f 74 0a 77 69 74 68 20 69 74 73 20 63 6f 6e  not.with its con
1590: 74 61 69 6e 65 72 2e 0a 5b 68 74 74 70 3a 2f 2f  tainer..[http://
15a0: 77 77 77 2e 70 61 75 6c 67 72 61 68 61 6d 2e 63  www.paulgraham.c
15b0: 6f 6d 2f 20 7c 20 50 61 75 6c 20 47 72 61 68 61  om/ | Paul Graha
15c0: 6d 5d 20 69 6e 20 68 69 73 20 62 6f 6f 6b 20 0a  m] in his book .
15d0: 3c 69 3e 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 70  <i>[http://www.p
15e0: 61 75 6c 67 72 61 68 61 6d 2e 63 6f 6d 2f 61 63  aulgraham.com/ac
15f0: 6c 2e 68 74 6d 6c 20 7c 20 41 4e 53 49 20 43 6f  l.html | ANSI Co
1600: 6d 6d 6f 6e 20 4c 69 73 70 5d 3c 2f 69 3e 3c 2f  mmon Lisp]</i></
1610: 61 3e 0a 63 61 6c 6c 73 20 74 68 69 73 20 70 72  a>.calls this pr
1620: 6f 70 65 72 74 79 20 22 4d 61 6e 69 66 65 73 74  operty "Manifest
1630: 20 54 79 70 69 6e 67 22 2e 0a 4f 74 68 65 72 20   Typing"..Other 
1640: 77 72 69 74 65 72 73 20 68 61 76 65 20 6f 74 68  writers have oth
1650: 65 72 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66  er definitions f
1660: 6f 72 20 74 68 65 20 74 65 72 6d 20 22 6d 61 6e  or the term "man
1670: 69 66 65 73 74 20 74 79 70 69 6e 67 22 2c 0a 73  ifest typing",.s
1680: 6f 20 62 65 77 61 72 65 20 6f 66 20 63 6f 6e 66  o beware of conf
1690: 75 73 69 6f 6e 2e 20 20 42 75 74 20 62 79 20 77  usion.  But by w
16a0: 68 61 74 65 76 65 72 20 6e 61 6d 65 2c 20 74 68  hatever name, th
16b0: 61 74 20 69 73 20 74 68 65 20 64 61 74 61 74 79  at is the dataty
16c0: 70 65 0a 6d 6f 64 65 6c 20 73 75 70 70 6f 72 74  pe.model support
16d0: 65 64 20 62 79 20 53 51 4c 69 74 65 20 33 2e 30  ed by SQLite 3.0
16e0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 64 64 69  ..</p>..<p>.Addi
16f0: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
1700: 6f 6e 20 61 62 6f 75 74 20 64 61 74 61 74 79 70  on about datatyp
1710: 65 73 20 69 6e 20 53 51 4c 69 74 65 20 76 65 72  es in SQLite ver
1720: 73 69 6f 6e 20 33 2e 30 20 69 73 0a 61 76 61 69  sion 3.0 is.avai
1730: 6c 61 62 6c 65 0a 3c 61 20 68 72 65 66 3d 22 64  lable.<a href="d
1740: 61 74 61 74 79 70 65 33 2e 68 74 6d 6c 22 3e 73  atatype3.html">s
1750: 65 70 61 72 61 74 65 6c 79 3c 2f 61 3e 2e 0a 3c  eparately</a>..<
1760: 2f 70 3e 0a 0a 3c 68 33 3e 53 75 70 70 6f 72 74  /p>..<h3>Support
1770: 20 66 6f 72 20 55 54 46 2d 38 20 61 6e 64 20 55   for UTF-8 and U
1780: 54 46 2d 31 36 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a  TF-16</h3>..<p>.
1790: 54 68 65 20 6e 65 77 20 41 50 49 20 66 6f 72 20  The new API for 
17a0: 53 51 4c 69 74 65 20 33 2e 30 20 63 6f 6e 74 61  SQLite 3.0 conta
17b0: 69 6e 73 20 72 6f 75 74 69 6e 65 73 20 74 68 61  ins routines tha
17c0: 74 20 61 63 63 65 70 74 20 74 65 78 74 20 61 73  t accept text as
17d0: 0a 62 6f 74 68 20 55 54 46 2d 38 20 61 6e 64 20  .both UTF-8 and 
17e0: 55 54 46 2d 31 36 20 69 6e 20 74 68 65 20 6e 61  UTF-16 in the na
17f0: 74 69 76 65 20 62 79 74 65 20 6f 72 64 65 72 20  tive byte order 
1800: 6f 66 20 74 68 65 20 68 6f 73 74 20 6d 61 63 68  of the host mach
1810: 69 6e 65 2e 0a 45 61 63 68 20 64 61 74 61 62 61  ine..Each databa
1820: 73 65 20 66 69 6c 65 20 6d 61 6e 61 67 65 73 20  se file manages 
1830: 74 65 78 74 20 61 73 20 65 69 74 68 65 72 20 55  text as either U
1840: 54 46 2d 38 2c 20 55 54 46 2d 31 36 42 45 20 28  TF-8, UTF-16BE (
1850: 62 69 67 2d 65 6e 64 69 61 6e 29 2c 0a 6f 72 20  big-endian),.or 
1860: 55 54 46 2d 31 36 4c 45 20 28 6c 69 74 74 6c 65  UTF-16LE (little
1870: 2d 65 6e 64 69 61 6e 29 2e 20 20 49 6e 74 65 72  -endian).  Inter
1880: 6e 61 6c 6c 79 20 61 6e 64 20 69 6e 20 74 68 65  nally and in the
1890: 20 64 69 73 6b 20 66 69 6c 65 2c 20 74 68 65 0a   disk file, the.
18a0: 73 61 6d 65 20 74 65 78 74 20 72 65 70 72 65 73  same text repres
18b0: 65 6e 74 61 74 69 6f 6e 20 69 73 20 75 73 65 64  entation is used
18c0: 20 65 76 65 72 79 77 68 65 72 65 2e 20 20 49 66   everywhere.  If
18d0: 20 74 68 65 20 74 65 78 74 20 72 65 70 72 65 73   the text repres
18e0: 65 6e 74 61 74 69 6f 6e 0a 73 70 65 63 69 66 69  entation.specifi
18f0: 65 64 20 62 79 20 74 68 65 20 64 61 74 61 62 61  ed by the databa
1900: 73 65 20 66 69 6c 65 20 28 69 6e 20 74 68 65 20  se file (in the 
1910: 66 69 6c 65 20 68 65 61 64 65 72 29 20 64 6f 65  file header) doe
1920: 73 20 6e 6f 74 20 6d 61 74 63 68 0a 74 68 65 20  s not match.the 
1930: 74 65 78 74 20 72 65 70 72 65 73 65 6e 74 61 74  text representat
1940: 69 6f 6e 20 72 65 71 75 69 72 65 64 20 62 79 20  ion required by 
1950: 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 72 6f  the interface ro
1960: 75 74 69 6e 65 73 2c 20 74 68 65 6e 20 74 65 78  utines, then tex
1970: 74 0a 69 73 20 63 6f 6e 76 65 72 74 65 64 20 6f  t.is converted o
1980: 6e 2d 74 68 65 2d 66 6c 79 2e 0a 43 6f 6e 73 74  n-the-fly..Const
1990: 61 6e 74 6c 79 20 63 6f 6e 76 65 72 74 69 6e 67  antly converting
19a0: 20 74 65 78 74 20 66 72 6f 6d 20 6f 6e 65 20 72   text from one r
19b0: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 74 6f  epresentation to
19c0: 20 61 6e 6f 74 68 65 72 20 63 61 6e 20 62 65 0a   another can be.
19d0: 63 6f 6d 70 75 74 61 74 69 6f 6e 61 6c 6c 79 20  computationally 
19e0: 65 78 70 65 6e 73 69 76 65 2c 20 73 6f 20 69 74  expensive, so it
19f0: 20 69 73 20 73 75 67 67 65 73 74 65 64 20 74 68   is suggested th
1a00: 61 74 20 70 72 6f 67 72 61 6d 6d 65 72 73 20 63  at programmers c
1a10: 68 6f 6f 73 65 20 61 0a 73 69 6e 67 6c 65 20 72  hoose a.single r
1a20: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 61 6e  epresentation an
1a30: 64 20 73 74 69 63 6b 20 77 69 74 68 20 69 74 20  d stick with it 
1a40: 74 68 72 6f 75 67 68 6f 75 74 20 74 68 65 69 72  throughout their
1a50: 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a 3c 2f   application..</
1a60: 70 3e 0a 0a 3c 70 3e 0a 49 6e 20 74 68 65 20 63  p>..<p>.In the c
1a70: 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74  urrent implement
1a80: 61 74 69 6f 6e 20 6f 66 20 53 51 4c 69 74 65 2c  ation of SQLite,
1a90: 20 74 68 65 20 53 51 4c 20 70 61 72 73 65 72 20   the SQL parser 
1aa0: 6f 6e 6c 79 20 77 6f 72 6b 73 0a 77 69 74 68 20  only works.with 
1ab0: 55 54 46 2d 38 20 74 65 78 74 2e 20 20 53 6f 20  UTF-8 text.  So 
1ac0: 69 66 20 79 6f 75 20 73 75 70 70 6c 79 20 55 54  if you supply UT
1ad0: 46 2d 31 36 20 74 65 78 74 20 69 74 20 77 69 6c  F-16 text it wil
1ae0: 6c 20 62 65 20 63 6f 6e 76 65 72 74 65 64 2e 0a  l be converted..
1af0: 54 68 69 73 20 69 73 20 6a 75 73 74 20 61 6e 20  This is just an 
1b00: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69  implementation i
1b10: 73 73 75 65 20 61 6e 64 20 74 68 65 72 65 20 69  ssue and there i
1b20: 73 20 6e 6f 74 68 69 6e 67 20 74 6f 20 70 72 65  s nothing to pre
1b30: 76 65 6e 74 0a 66 75 74 75 72 65 20 76 65 72 73  vent.future vers
1b40: 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 66  ions of SQLite f
1b50: 72 6f 6d 20 70 61 72 73 69 6e 67 20 55 54 46 2d  rom parsing UTF-
1b60: 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 6e  16 encoded SQL n
1b70: 61 74 69 76 65 6c 79 2e 0a 3c 2f 70 3e 0a 0a 3c  atively..</p>..<
1b80: 70 3e 0a 57 68 65 6e 20 63 72 65 61 74 69 6e 67  p>.When creating
1b90: 20 6e 65 77 20 75 73 65 72 2d 64 65 66 69 6e 65   new user-define
1ba0: 64 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20  d SQL functions 
1bb0: 61 6e 64 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65  and collating se
1bc0: 71 75 65 6e 63 65 73 2c 0a 65 61 63 68 20 66 75  quences,.each fu
1bd0: 6e 63 74 69 6f 6e 20 6f 72 20 63 6f 6c 6c 61 74  nction or collat
1be0: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 63 61 6e  ing sequence can
1bf0: 20 73 70 65 63 69 66 79 20 69 66 20 69 74 20 77   specify if it w
1c00: 6f 72 6b 73 20 77 69 74 68 0a 55 54 46 2d 38 2c  orks with.UTF-8,
1c10: 20 55 54 46 2d 31 36 62 65 2c 20 6f 72 20 55 54   UTF-16be, or UT
1c20: 46 2d 31 36 6c 65 2e 20 20 53 65 70 61 72 61 74  F-16le.  Separat
1c30: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
1c40: 73 20 63 61 6e 20 62 65 20 72 65 67 69 73 74 65  s can be registe
1c50: 72 65 64 0a 66 6f 72 20 65 61 63 68 20 65 6e 63  red.for each enc
1c60: 6f 64 69 6e 67 2e 20 20 20 49 66 20 61 6e 20 53  oding.   If an S
1c70: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 6f 72 20 63  QL function or c
1c80: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63  ollating sequenc
1c90: 65 20 69 73 20 72 65 71 75 69 72 65 64 0a 62 75  e is required.bu
1ca0: 74 20 61 20 76 65 72 73 69 6f 6e 20 66 6f 72 20  t a version for 
1cb0: 74 68 65 20 63 75 72 72 65 6e 74 20 74 65 78 74  the current text
1cc0: 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 6e 6f 74   encoding is not
1cd0: 20 61 76 61 69 6c 61 62 6c 65 2c 20 74 68 65 6e   available, then
1ce0: 20 0a 74 68 65 20 74 65 78 74 20 69 73 20 61 75   .the text is au
1cf0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6f 6e 76  tomatically conv
1d00: 65 72 74 65 64 2e 20 20 41 73 20 62 65 66 6f 72  erted.  As befor
1d10: 65 2c 20 74 68 69 73 20 63 6f 6e 76 65 72 73 69  e, this conversi
1d20: 6f 6e 20 74 61 6b 65 73 0a 63 6f 6d 70 75 74 61  on takes.computa
1d30: 74 69 6f 6e 20 74 69 6d 65 2c 20 73 6f 20 70 72  tion time, so pr
1d40: 6f 67 72 61 6d 6d 65 72 73 20 61 72 65 20 61 64  ogrammers are ad
1d50: 76 69 73 65 64 20 74 6f 20 70 69 63 6b 20 61 20  vised to pick a 
1d60: 73 69 6e 67 6c 65 0a 65 6e 63 6f 64 69 6e 67 20  single.encoding 
1d70: 61 6e 64 20 73 74 69 63 6b 20 77 69 74 68 20 69  and stick with i
1d80: 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6d 69  t in order to mi
1d90: 6e 69 6d 69 7a 65 20 74 68 65 20 61 6d 6f 75 6e  nimize the amoun
1da0: 74 20 6f 66 20 75 6e 6e 65 63 65 73 73 61 72 79  t of unnecessary
1db0: 0a 66 6f 72 6d 61 74 20 6a 75 67 67 6c 69 6e 67  .format juggling
1dc0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 51 4c 69  ..</p>..<p>.SQLi
1dd0: 74 65 20 69 73 20 6e 6f 74 20 70 61 72 74 69 63  te is not partic
1de0: 75 6c 61 72 20 61 62 6f 75 74 20 74 68 65 20 74  ular about the t
1df0: 65 78 74 20 69 74 20 72 65 63 65 69 76 65 73 20  ext it receives 
1e00: 61 6e 64 20 69 73 20 6d 6f 72 65 20 74 68 61 6e  and is more than
1e10: 0a 68 61 70 70 79 20 74 6f 20 70 72 6f 63 65 73  .happy to proces
1e20: 73 20 74 65 78 74 20 73 74 72 69 6e 67 73 20 74  s text strings t
1e30: 68 61 74 20 61 72 65 20 6e 6f 74 20 6e 6f 72 6d  hat are not norm
1e40: 61 6c 69 7a 65 64 20 6f 72 20 65 76 65 6e 0a 77  alized or even.w
1e50: 65 6c 6c 2d 66 6f 72 6d 65 64 20 55 54 46 2d 38  ell-formed UTF-8
1e60: 20 6f 72 20 55 54 46 2d 31 36 2e 20 20 54 68 75   or UTF-16.  Thu
1e70: 73 2c 20 70 72 6f 67 72 61 6d 6d 65 72 73 20 77  s, programmers w
1e80: 68 6f 20 77 61 6e 74 20 74 6f 20 73 74 6f 72 65  ho want to store
1e90: 0a 49 53 30 38 38 35 39 20 64 61 74 61 20 63 61  .IS08859 data ca
1ea0: 6e 20 64 6f 20 73 6f 20 75 73 69 6e 67 20 74 68  n do so using th
1eb0: 65 20 55 54 46 2d 38 20 69 6e 74 65 72 66 61 63  e UTF-8 interfac
1ec0: 65 73 2e 20 20 41 73 20 6c 6f 6e 67 20 61 73 20  es.  As long as 
1ed0: 6e 6f 0a 61 74 74 65 6d 70 74 73 20 61 72 65 20  no.attempts are 
1ee0: 6d 61 64 65 20 74 6f 20 75 73 65 20 61 20 55 54  made to use a UT
1ef0: 46 2d 31 36 20 63 6f 6c 6c 61 74 69 6e 67 20 73  F-16 collating s
1f00: 65 71 75 65 6e 63 65 20 6f 72 20 53 51 4c 20 66  equence or SQL f
1f10: 75 6e 63 74 69 6f 6e 2c 0a 74 68 65 20 62 79 74  unction,.the byt
1f20: 65 20 73 65 71 75 65 6e 63 65 20 6f 66 20 74 68  e sequence of th
1f30: 65 20 74 65 78 74 20 77 69 6c 6c 20 6e 6f 74 20  e text will not 
1f40: 62 65 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 61  be modified in a
1f50: 6e 79 20 77 61 79 2e 0a 3c 2f 70 3e 0a 0a 3c 68  ny way..</p>..<h
1f60: 33 3e 55 73 65 72 2d 64 65 66 69 6e 65 64 20 43  3>User-defined C
1f70: 6f 6c 6c 61 74 69 6e 67 20 53 65 71 75 65 6e 63  ollating Sequenc
1f80: 65 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 41 20 63  es</h3>..<p>.A c
1f90: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63  ollating sequenc
1fa0: 65 20 69 73 20 6a 75 73 74 20 61 20 64 65 66 69  e is just a defi
1fb0: 6e 65 64 20 6f 72 64 65 72 20 66 6f 72 20 74 65  ned order for te
1fc0: 78 74 2e 20 20 57 68 65 6e 20 53 51 4c 69 74 65  xt.  When SQLite
1fd0: 20 33 2e 30 0a 73 6f 72 74 73 20 28 6f 72 20 75   3.0.sorts (or u
1fe0: 73 65 73 20 61 20 63 6f 6d 70 61 72 69 73 6f 6e  ses a comparison
1ff0: 20 6f 70 65 72 61 74 6f 72 20 6c 69 6b 65 20 22   operator like "
2000: 26 6c 74 3b 22 20 6f 72 20 22 26 67 74 3b 3d 22  &lt;" or "&gt;="
2010: 29 20 74 68 65 20 73 6f 72 74 0a 6f 72 64 65 72  ) the sort.order
2020: 20 69 73 20 66 69 72 73 74 20 64 65 74 65 72 6d   is first determ
2030: 69 6e 65 64 20 62 79 20 74 68 65 20 64 61 74 61  ined by the data
2040: 20 74 79 70 65 2e 0a 3c 2f 70 3e 0a 0a 3c 75 6c   type..</p>..<ul
2050: 3e 0a 3c 6c 69 3e 4e 55 4c 4c 73 20 73 6f 72 74  >.<li>NULLs sort
2060: 20 66 69 72 73 74 3c 2f 6c 69 3e 0a 3c 6c 69 3e   first</li>.<li>
2070: 4e 75 6d 65 72 69 63 20 76 61 6c 75 65 73 20 73  Numeric values s
2080: 6f 72 74 20 6e 65 78 74 20 69 6e 20 6e 75 6d 65  ort next in nume
2090: 72 69 63 61 6c 20 6f 72 64 65 72 3c 2f 6c 69 3e  rical order</li>
20a0: 0a 3c 6c 69 3e 54 65 78 74 20 76 61 6c 75 65 73  .<li>Text values
20b0: 20 63 6f 6d 65 20 61 66 74 65 72 20 6e 75 6d 65   come after nume
20c0: 72 69 63 73 3c 2f 6c 69 3e 0a 3c 6c 69 3e 42 4c  rics</li>.<li>BL
20d0: 4f 42 73 20 73 6f 72 74 20 6c 61 73 74 3c 2f 6c  OBs sort last</l
20e0: 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 0a 43 6f  i>.</ul>..<p>.Co
20f0: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65  llating sequence
2100: 73 20 61 72 65 20 75 73 65 64 20 66 6f 72 20 63  s are used for c
2110: 6f 6d 70 61 72 69 6e 67 20 74 77 6f 20 74 65 78  omparing two tex
2120: 74 20 73 74 72 69 6e 67 73 2e 0a 54 68 65 20 63  t strings..The c
2130: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63  ollating sequenc
2140: 65 20 64 6f 65 73 20 6e 6f 74 20 63 68 61 6e 67  e does not chang
2150: 65 20 74 68 65 20 6f 72 64 65 72 69 6e 67 20 6f  e the ordering o
2160: 66 20 4e 55 4c 4c 73 2c 20 6e 75 6d 62 65 72 73  f NULLs, numbers
2170: 2c 0a 6f 72 20 42 4c 4f 42 73 2c 20 6f 6e 6c 79  ,.or BLOBs, only
2180: 20 74 65 78 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e   text..</p>..<p>
2190: 0a 41 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71  .A collating seq
21a0: 75 65 6e 63 65 20 69 73 20 69 6d 70 6c 65 6d 65  uence is impleme
21b0: 6e 74 65 64 20 61 73 20 61 20 66 75 6e 63 74 69  nted as a functi
21c0: 6f 6e 20 74 68 61 74 20 74 61 6b 65 73 20 74 68  on that takes th
21d0: 65 0a 74 77 6f 20 73 74 72 69 6e 67 73 20 62 65  e.two strings be
21e0: 69 6e 67 20 63 6f 6d 70 61 72 65 64 20 61 73 20  ing compared as 
21f0: 69 6e 70 75 74 73 20 61 6e 64 20 72 65 74 75 72  inputs and retur
2200: 6e 73 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72  ns negative, zer
2210: 6f 2c 20 6f 72 0a 70 6f 73 69 74 69 76 65 20 69  o, or.positive i
2220: 66 20 74 68 65 20 66 69 72 73 74 20 73 74 72 69  f the first stri
2230: 6e 67 20 69 73 20 6c 65 73 73 20 74 68 61 6e 2c  ng is less than,
2240: 20 65 71 75 61 6c 20 74 6f 2c 20 6f 72 20 67 72   equal to, or gr
2250: 65 61 74 65 72 20 74 68 61 6e 0a 74 68 65 20 73  eater than.the s
2260: 65 63 6f 6e 64 2e 0a 53 51 4c 69 74 65 20 33 2e  econd..SQLite 3.
2270: 30 20 63 6f 6d 65 73 20 77 69 74 68 20 61 20 73  0 comes with a s
2280: 69 6e 67 6c 65 20 62 75 69 6c 74 2d 69 6e 20 63  ingle built-in c
2290: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63  ollating sequenc
22a0: 65 20 6e 61 6d 65 64 20 22 42 49 4e 41 52 59 22  e named "BINARY"
22b0: 0a 77 68 69 63 68 20 69 73 20 69 6d 70 6c 65 6d  .which is implem
22c0: 65 6e 74 65 64 20 75 73 69 6e 67 20 74 68 65 20  ented using the 
22d0: 6d 65 6d 63 6d 70 28 29 20 72 6f 75 74 69 6e 65  memcmp() routine
22e0: 20 66 72 6f 6d 20 74 68 65 20 73 74 61 6e 64 61   from the standa
22f0: 72 64 20 43 20 6c 69 62 72 61 72 79 2e 0a 54 68  rd C library..Th
2300: 65 20 42 49 4e 41 52 59 20 63 6f 6c 6c 61 74 69  e BINARY collati
2310: 6e 67 20 73 65 71 75 65 6e 63 65 20 77 6f 72 6b  ng sequence work
2320: 73 20 77 65 6c 6c 20 66 6f 72 20 45 6e 67 6c 69  s well for Engli
2330: 73 68 20 74 65 78 74 2e 20 20 46 6f 72 20 6f 74  sh text.  For ot
2340: 68 65 72 0a 6c 61 6e 67 75 61 67 65 73 20 6f 72  her.languages or
2350: 20 6c 6f 63 61 6c 65 73 2c 20 61 6c 74 65 72 6e   locales, altern
2360: 61 74 69 76 65 20 63 6f 6c 6c 61 74 69 6e 67 20  ative collating 
2370: 73 65 71 75 65 6e 63 65 73 20 6d 61 79 20 62 65  sequences may be
2380: 20 70 72 65 66 65 72 72 65 64 2e 0a 3c 2f 70 3e   preferred..</p>
2390: 0a 0a 3c 70 3e 0a 54 68 65 20 64 65 63 69 73 69  ..<p>.The decisi
23a0: 6f 6e 20 6f 66 20 77 68 69 63 68 20 63 6f 6c 6c  on of which coll
23b0: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 74  ating sequence t
23c0: 6f 20 75 73 65 20 69 73 20 63 6f 6e 74 72 6f 6c  o use is control
23d0: 6c 65 64 20 62 79 20 74 68 65 0a 43 4f 4c 4c 41  led by the.COLLA
23e0: 54 45 20 63 6c 61 75 73 65 20 69 6e 20 53 51 4c  TE clause in SQL
23f0: 2e 20 20 41 20 43 4f 4c 4c 41 54 45 20 63 6c 61  .  A COLLATE cla
2400: 75 73 65 20 63 61 6e 20 6f 63 63 75 72 20 6f 6e  use can occur on
2410: 20 61 20 74 61 62 6c 65 20 64 65 66 69 6e 69 74   a table definit
2420: 69 6f 6e 2c 0a 74 6f 20 64 65 66 69 6e 65 20 61  ion,.to define a
2430: 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69   default collati
2440: 6e 67 20 73 65 71 75 65 6e 63 65 20 74 6f 20 61  ng sequence to a
2450: 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 2c 20 6f   table column, o
2460: 72 20 6f 6e 20 66 69 65 6c 64 0a 6f 66 20 61 6e  r on field.of an
2470: 20 69 6e 64 65 78 2c 20 6f 72 20 69 6e 20 74 68   index, or in th
2480: 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  e ORDER BY claus
2490: 65 20 6f 66 20 61 20 53 45 4c 45 43 54 20 73 74  e of a SELECT st
24a0: 61 74 65 6d 65 6e 74 2e 0a 50 6c 61 6e 6e 65 64  atement..Planned
24b0: 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74 6f   enhancements to
24c0: 20 53 51 4c 69 74 65 20 61 72 65 20 74 6f 20 69   SQLite are to i
24d0: 6e 63 6c 75 64 65 20 73 74 61 6e 64 61 72 64 20  nclude standard 
24e0: 43 41 53 54 28 29 20 73 79 6e 74 61 78 0a 74 6f  CAST() syntax.to
24f0: 20 61 6c 6c 6f 77 20 74 68 65 20 63 6f 6c 6c 61   allow the colla
2500: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 6f 66  ting sequence of
2510: 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 74   an expression t
2520: 6f 20 62 65 20 64 65 66 69 6e 65 64 2e 0a 3c 2f  o be defined..</
2530: 70 3e 0a 0a 3c 68 33 3e 36 34 2d 62 69 74 20 52  p>..<h3>64-bit R
2540: 4f 57 49 44 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a  OWIDs</h3>..<p>.
2550: 45 76 65 72 79 20 72 6f 77 20 6f 66 20 61 20 74  Every row of a t
2560: 61 62 6c 65 20 68 61 73 20 61 20 75 6e 69 71 75  able has a uniqu
2570: 65 20 72 6f 77 69 64 2e 0a 49 66 20 74 68 65 20  e rowid..If the 
2580: 74 61 62 6c 65 20 64 65 66 69 6e 65 73 20 61 20  table defines a 
2590: 63 6f 6c 75 6d 6e 20 77 69 74 68 20 74 68 65 20  column with the 
25a0: 74 79 70 65 20 22 49 4e 54 45 47 45 52 20 50 52  type "INTEGER PR
25b0: 49 4d 41 52 59 20 4b 45 59 22 20 74 68 65 6e 20  IMARY KEY" then 
25c0: 74 68 61 74 0a 63 6f 6c 75 6d 6e 20 62 65 63 6f  that.column beco
25d0: 6d 65 73 20 61 6e 20 61 6c 69 61 73 20 66 6f 72  mes an alias for
25e0: 20 74 68 65 20 72 6f 77 69 64 2e 20 20 42 75 74   the rowid.  But
25f0: 20 77 69 74 68 20 6f 72 20 77 69 74 68 6f 75 74   with or without
2600: 20 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d   an INTEGER PRIM
2610: 41 52 59 0a 4b 45 59 20 63 6f 6c 75 6d 6e 2c 20  ARY.KEY column, 
2620: 65 76 65 72 79 20 72 6f 77 20 73 74 69 6c 6c 20  every row still 
2630: 68 61 73 20 61 20 72 6f 77 69 64 2e 0a 3c 2f 70  has a rowid..</p
2640: 3e 0a 0a 3c 70 3e 0a 49 6e 20 53 51 4c 69 74 65  >..<p>.In SQLite
2650: 20 76 65 72 73 69 6f 6e 20 33 2e 30 2c 20 74 68   version 3.0, th
2660: 65 20 72 6f 77 69 64 20 69 73 20 61 20 36 34 2d  e rowid is a 64-
2670: 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65 67  bit signed integ
2680: 65 72 2e 0a 54 68 69 73 20 69 73 20 61 6e 20 65  er..This is an e
2690: 78 70 61 6e 73 69 6f 6e 20 6f 66 20 53 51 4c 69  xpansion of SQLi
26a0: 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 20 77  te version 2.8 w
26b0: 68 69 63 68 20 6f 6e 6c 79 20 70 65 72 6d 69 74  hich only permit
26c0: 74 65 64 0a 72 6f 77 69 64 73 20 6f 66 20 33 32  ted.rowids of 32
26d0: 2d 62 69 74 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e  -bits..</p>..<p>
26e0: 0a 54 6f 20 6d 69 6e 69 6d 69 7a 65 20 73 74 6f  .To minimize sto
26f0: 72 61 67 65 20 73 70 61 63 65 2c 20 74 68 65 20  rage space, the 
2700: 36 34 2d 62 69 74 20 72 6f 77 69 64 20 69 73 20  64-bit rowid is 
2710: 73 74 6f 72 65 64 20 61 73 20 61 20 76 61 72 69  stored as a vari
2720: 61 62 6c 65 20 6c 65 6e 67 74 68 0a 69 6e 74 65  able length.inte
2730: 67 65 72 2e 20 20 52 6f 77 69 64 73 20 62 65 74  ger.  Rowids bet
2740: 77 65 65 6e 20 30 20 61 6e 64 20 31 32 37 20 75  ween 0 and 127 u
2750: 73 65 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65  se only a single
2760: 20 62 79 74 65 2e 20 20 0a 52 6f 77 69 64 73 20   byte.  .Rowids 
2770: 62 65 74 77 65 65 6e 20 30 20 61 6e 64 20 31 36  between 0 and 16
2780: 33 38 33 20 75 73 65 20 6a 75 73 74 20 32 20 62  383 use just 2 b
2790: 79 74 65 73 2e 20 20 55 70 20 74 6f 20 32 30 39  ytes.  Up to 209
27a0: 37 31 35 32 20 75 73 65 73 20 74 68 72 65 65 0a  7152 uses three.
27b0: 62 79 74 65 73 2e 20 20 41 6e 64 20 73 6f 20 66  bytes.  And so f
27c0: 6f 72 74 68 2e 20 20 4e 65 67 61 74 69 76 65 20  orth.  Negative 
27d0: 72 6f 77 69 64 73 20 61 72 65 20 61 6c 6c 6f 77  rowids are allow
27e0: 65 64 20 62 75 74 20 74 68 65 79 20 61 6c 77 61  ed but they alwa
27f0: 79 73 20 75 73 65 0a 6e 69 6e 65 20 62 79 74 65  ys use.nine byte
2800: 73 20 6f 66 20 73 74 6f 72 61 67 65 20 61 6e 64  s of storage and
2810: 20 73 6f 20 74 68 65 69 72 20 75 73 65 20 69 73   so their use is
2820: 20 64 69 73 63 6f 75 72 61 67 65 64 2e 20 20 57   discouraged.  W
2830: 68 65 6e 20 72 6f 77 69 64 73 0a 61 72 65 20 67  hen rowids.are g
2840: 65 6e 65 72 61 74 65 64 20 61 75 74 6f 6d 61 74  enerated automat
2850: 69 63 61 6c 6c 79 20 62 79 20 53 51 4c 69 74 65  ically by SQLite
2860: 2c 20 74 68 65 79 20 77 69 6c 6c 20 61 6c 77 61  , they will alwa
2870: 79 73 20 62 65 20 6e 6f 6e 2d 6e 65 67 61 74 69  ys be non-negati
2880: 76 65 2e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e 49 6d  ve..</p>..<h3>Im
2890: 70 72 6f 76 65 64 20 43 6f 6e 63 75 72 72 65 6e  proved Concurren
28a0: 63 79 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 53 51 4c  cy</h3>..<p>.SQL
28b0: 69 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 20  ite version 2.8 
28c0: 61 6c 6c 6f 77 65 64 20 6d 75 6c 74 69 70 6c 65  allowed multiple
28d0: 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 20 72 65   simultaneous re
28e0: 61 64 65 72 73 20 6f 72 20 61 20 73 69 6e 67 6c  aders or a singl
28f0: 65 0a 77 72 69 74 65 72 20 62 75 74 20 6e 6f 74  e.writer but not
2900: 20 62 6f 74 68 2e 20 20 53 51 4c 69 74 65 20 76   both.  SQLite v
2910: 65 72 73 69 6f 6e 20 33 2e 30 20 61 6c 6c 6f 77  ersion 3.0 allow
2920: 73 20 6f 6e 65 20 70 72 6f 63 65 73 73 20 74 6f  s one process to
2930: 20 62 65 67 69 6e 0a 77 72 69 74 69 6e 67 20 74   begin.writing t
2940: 68 65 20 64 61 74 61 62 61 73 65 20 77 68 69 6c  he database whil
2950: 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 65  e other processe
2960: 73 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 72 65  s continue to re
2970: 61 64 2e 20 20 54 68 65 0a 77 72 69 74 65 72 20  ad.  The.writer 
2980: 6d 75 73 74 20 73 74 69 6c 6c 20 6f 62 74 61 69  must still obtai
2990: 6e 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c  n an exclusive l
29a0: 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62  ock on the datab
29b0: 61 73 65 20 66 6f 72 20 61 20 62 72 69 65 66 0a  ase for a brief.
29c0: 69 6e 74 65 72 76 61 6c 20 69 6e 20 6f 72 64 65  interval in orde
29d0: 72 20 74 6f 20 63 6f 6d 6d 69 74 20 69 74 73 20  r to commit its 
29e0: 63 68 61 6e 67 65 73 2c 20 62 75 74 20 74 68 65  changes, but the
29f0: 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20   exclusive lock 
2a00: 69 73 20 6e 6f 0a 6c 6f 6e 67 65 72 20 72 65 71  is no.longer req
2a10: 75 69 72 65 64 20 66 6f 72 20 74 68 65 20 65 6e  uired for the en
2a20: 74 69 72 65 20 77 72 69 74 65 20 6f 70 65 72 61  tire write opera
2a30: 74 69 6f 6e 2e 0a 41 20 3c 61 20 68 72 65 66 3d  tion..A <a href=
2a40: 22 6c 6f 63 6b 69 6e 67 76 33 2e 68 74 6d 6c 22  "lockingv3.html"
2a50: 3e 6d 6f 72 65 20 64 65 74 61 69 6c 65 64 20 72  >more detailed r
2a60: 65 70 6f 72 74 3c 2f 61 3e 20 6f 6e 20 74 68 65  eport</a> on the
2a70: 20 6c 6f 63 6b 69 6e 67 0a 62 65 68 61 76 69 6f   locking.behavio
2a80: 72 20 6f 66 20 53 51 4c 69 74 65 20 76 65 72 73  r of SQLite vers
2a90: 69 6f 6e 20 33 2e 30 20 69 73 20 61 76 61 69 6c  ion 3.0 is avail
2aa0: 61 62 6c 65 20 73 65 70 61 72 61 74 65 6c 79 2e  able separately.
2ab0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6c 69 6d  .</p>..<p>.A lim
2ac0: 69 74 65 64 20 66 6f 72 6d 20 6f 66 20 74 61 62  ited form of tab
2ad0: 6c 65 2d 6c 65 76 65 6c 20 6c 6f 63 6b 69 6e 67  le-level locking
2ae0: 20 69 73 20 6e 6f 77 20 61 6c 73 6f 20 61 76 61   is now also ava
2af0: 69 6c 61 62 6c 65 20 69 6e 20 53 51 4c 69 74 65  ilable in SQLite
2b00: 2e 0a 49 66 20 65 61 63 68 20 74 61 62 6c 65 20  ..If each table 
2b10: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73  is stored in a s
2b20: 65 70 61 72 61 74 65 20 64 61 74 61 62 61 73 65  eparate database
2b30: 20 66 69 6c 65 2c 20 74 68 6f 73 65 20 73 65 70   file, those sep
2b40: 61 72 61 74 65 0a 66 69 6c 65 73 20 63 61 6e 20  arate.files can 
2b50: 62 65 20 61 74 74 61 63 68 65 64 20 74 6f 20 74  be attached to t
2b60: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
2b70: 20 28 75 73 69 6e 67 20 74 68 65 20 41 54 54 41   (using the ATTA
2b80: 43 48 20 63 6f 6d 6d 61 6e 64 29 0a 61 6e 64 20  CH command).and 
2b90: 74 68 65 20 63 6f 6d 62 69 6e 65 64 20 64 61 74  the combined dat
2ba0: 61 62 61 73 65 73 20 77 69 6c 6c 20 66 75 6e 63  abases will func
2bb0: 74 69 6f 6e 20 61 73 20 6f 6e 65 2e 20 20 42 75  tion as one.  Bu
2bc0: 74 20 6c 6f 63 6b 73 20 77 69 6c 6c 20 6f 6e 6c  t locks will onl
2bd0: 79 0a 62 65 20 61 63 71 75 69 72 65 64 20 6f 6e  y.be acquired on
2be0: 20 69 6e 64 69 76 69 64 75 61 6c 20 66 69 6c 65   individual file
2bf0: 73 20 61 73 20 6e 65 65 64 65 64 2e 20 20 53 6f  s as needed.  So
2c00: 20 69 66 20 79 6f 75 20 72 65 64 65 66 69 6e 65   if you redefine
2c10: 20 22 64 61 74 61 62 61 73 65 22 0a 74 6f 20 6d   "database".to m
2c20: 65 61 6e 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20  ean two or more 
2c30: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 2c 20  database files, 
2c40: 74 68 65 6e 20 69 74 20 69 73 20 65 6e 74 69 72  then it is entir
2c50: 65 6c 79 20 70 6f 73 73 69 62 6c 65 20 66 6f 72  ely possible for
2c60: 0a 74 77 6f 20 70 72 6f 63 65 73 73 65 73 20 74  .two processes t
2c70: 6f 20 62 65 20 77 72 69 74 69 6e 67 20 74 6f 20  o be writing to 
2c80: 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73  the same databas
2c90: 65 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69  e at the same ti
2ca0: 6d 65 2e 0a 54 6f 20 66 75 72 74 68 65 72 20 73  me..To further s
2cb0: 75 70 70 6f 72 74 20 74 68 69 73 20 63 61 70 61  upport this capa
2cc0: 62 69 6c 69 74 79 2c 20 63 6f 6d 6d 69 74 73 20  bility, commits 
2cd0: 6f 66 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20  of transactions 
2ce0: 69 6e 76 6f 6c 76 69 6e 67 0a 74 77 6f 20 6f 72  involving.two or
2cf0: 20 6d 6f 72 65 20 41 54 54 41 43 48 65 64 20 64   more ATTACHed d
2d00: 61 74 61 62 61 73 65 20 61 72 65 20 6e 6f 77 20  atabase are now 
2d10: 61 74 6f 6d 69 63 2e 0a 3c 2f 70 3e 0a 0a 3c 68  atomic..</p>..<h
2d20: 33 3e 43 72 65 64 69 74 73 3c 2f 68 33 3e 0a 0a  3>Credits</h3>..
2d30: 3c 70 3e 0a 53 51 4c 69 74 65 20 76 65 72 73 69  <p>.SQLite versi
2d40: 6f 6e 20 33 2e 30 20 69 73 20 6d 61 64 65 20 70  on 3.0 is made p
2d50: 6f 73 73 69 62 6c 65 20 69 6e 20 70 61 72 74 20  ossible in part 
2d60: 62 79 20 41 4f 4c 20 64 65 76 65 6c 6f 70 65 72  by AOL developer
2d70: 73 0a 73 75 70 70 6f 72 74 69 6e 67 20 61 6e 64  s.supporting and
2d80: 20 65 6d 62 72 61 63 69 6e 67 20 67 72 65 61 74   embracing great
2d90: 20 4f 70 65 6e 2d 53 6f 75 72 63 65 20 53 6f 66   Open-Source Sof
2da0: 74 77 61 72 65 2e 0a 3c 2f 70 3e 0a              tware..</p>.