/ Hex Artifact Content
Login

Artifact 0fe2b810f114a909b844e50ad37a25e6ed8c7271:


0000: 23 0a 23 20 52 75 6e 20 74 68 69 73 20 73 63 72  #.# Run this scr
0010: 69 70 74 20 74 6f 20 67 65 6e 65 72 61 74 65 64  ipt to generated
0020: 20 61 20 64 61 74 61 74 79 70 65 73 2e 68 74 6d   a datatypes.htm
0030: 6c 20 6f 75 74 70 75 74 20 66 69 6c 65 0a 23 0a  l output file.#.
0040: 73 65 74 20 72 63 73 69 64 20 7b 24 49 64 3a 20  set rcsid {$Id: 
0050: 64 61 74 61 74 79 70 65 73 2e 74 63 6c 2c 76 20  datatypes.tcl,v 
0060: 31 2e 36 20 32 30 30 33 2f 31 32 2f 31 38 20 31  1.6 2003/12/18 1
0070: 34 3a 31 39 3a 34 31 20 64 72 68 20 45 78 70 20  4:19:41 drh Exp 
0080: 24 7d 0a 0a 70 75 74 73 20 7b 3c 68 74 6d 6c 3e  $}..puts {<html>
0090: 0a 3c 68 65 61 64 3e 0a 20 20 3c 74 69 74 6c 65  .<head>.  <title
00a0: 3e 44 61 74 61 74 79 70 65 73 20 49 6e 20 53 51  >Datatypes In SQ
00b0: 4c 69 74 65 3c 2f 74 69 74 6c 65 3e 0a 3c 2f 68  Lite</title>.</h
00c0: 65 61 64 3e 0a 3c 62 6f 64 79 20 62 67 63 6f 6c  ead>.<body bgcol
00d0: 6f 72 3d 22 77 68 69 74 65 22 3e 0a 3c 68 31 20  or="white">.<h1 
00e0: 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 0a  align="center">.
00f0: 44 61 74 61 74 79 70 65 73 20 49 6e 20 53 51 4c  Datatypes In SQL
0100: 69 74 65 0a 3c 2f 68 31 3e 0a 7d 0a 70 75 74 73  ite.</h1>.}.puts
0110: 20 22 3c 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65   "<p align=cente
0120: 72 3e 0a 28 54 68 69 73 20 70 61 67 65 20 77 61  r>.(This page wa
0130: 73 20 6c 61 73 74 20 6d 6f 64 69 66 69 65 64 20  s last modified 
0140: 6f 6e 20 5b 6c 72 61 6e 67 65 20 24 72 63 73 69  on [lrange $rcsi
0150: 64 20 33 20 34 5d 20 55 54 43 29 0a 3c 2f 70 3e  d 3 4] UTC).</p>
0160: 22 0a 0a 70 75 74 73 20 7b 3c 68 32 3e 31 2e 30  "..puts {<h2>1.0
0170: 20 26 6e 62 73 70 3b 20 54 79 70 65 6c 65 73 73   &nbsp; Typeless
0180: 6e 65 73 73 3c 2f 68 32 3e 0a 3c 70 3e 0a 53 51  ness</h2>.<p>.SQ
0190: 4c 69 74 65 20 69 73 20 22 74 79 70 65 6c 65 73  Lite is "typeles
01a0: 73 22 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20  s".  This means 
01b0: 74 68 61 74 20 79 6f 75 20 63 61 6e 20 73 74 6f  that you can sto
01c0: 72 65 20 61 6e 79 0a 6b 69 6e 64 20 6f 66 20 64  re any.kind of d
01d0: 61 74 61 20 79 6f 75 20 77 61 6e 74 20 69 6e 20  ata you want in 
01e0: 61 6e 79 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 6e  any column of an
01f0: 79 20 74 61 62 6c 65 2c 20 72 65 67 61 72 64 6c  y table, regardl
0200: 65 73 73 20 6f 66 20 74 68 65 0a 64 65 63 6c 61  ess of the.decla
0210: 72 65 64 20 64 61 74 61 74 79 70 65 20 6f 66 20  red datatype of 
0220: 74 68 61 74 20 63 6f 6c 75 6d 6e 2e 20 20 0a 28  that column.  .(
0230: 53 65 65 20 74 68 65 20 6f 6e 65 20 65 78 63 65  See the one exce
0240: 70 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 72 75  ption to this ru
0250: 6c 65 20 69 6e 20 73 65 63 74 69 6f 6e 20 32 2e  le in section 2.
0260: 30 20 62 65 6c 6f 77 2e 29 0a 54 68 69 73 20 62  0 below.).This b
0270: 65 68 61 76 69 6f 72 20 69 73 20 61 20 66 65 61  ehavior is a fea
0280: 74 75 72 65 2c 20 6e 6f 74 0a 61 20 62 75 67 2e  ture, not.a bug.
0290: 20 20 41 20 64 61 74 61 62 61 73 65 20 69 73 20    A database is 
02a0: 73 75 70 70 6f 73 65 20 74 6f 20 73 74 6f 72 65  suppose to store
02b0: 20 61 6e 64 20 72 65 74 72 69 65 76 65 20 64 61   and retrieve da
02c0: 74 61 20 61 6e 64 20 69 74 20 0a 73 68 6f 75 6c  ta and it .shoul
02d0: 64 20 6e 6f 74 20 6d 61 74 74 65 72 20 74 6f 20  d not matter to 
02e0: 74 68 65 20 64 61 74 61 62 61 73 65 20 77 68 61  the database wha
02f0: 74 20 66 6f 72 6d 61 74 20 74 68 61 74 20 64 61  t format that da
0300: 74 61 20 69 73 20 69 6e 2e 0a 54 68 65 20 73 74  ta is in..The st
0310: 72 6f 6e 67 20 74 79 70 69 6e 67 20 73 79 73 74  rong typing syst
0320: 65 6d 20 66 6f 75 6e 64 20 69 6e 20 6d 6f 73 74  em found in most
0330: 20 6f 74 68 65 72 20 53 51 4c 20 65 6e 67 69 6e   other SQL engin
0340: 65 73 20 61 6e 64 0a 63 6f 64 69 66 69 65 64 20  es and.codified 
0350: 69 6e 20 74 68 65 20 53 51 4c 20 6c 61 6e 67 75  in the SQL langu
0360: 61 67 65 20 73 70 65 63 20 69 73 20 61 20 6d 69  age spec is a mi
0370: 73 66 65 61 74 75 72 65 20 2d 0a 69 74 20 69 73  sfeature -.it is
0380: 20 61 6e 20 65 78 61 6d 70 6c 65 20 6f 66 20 74   an example of t
0390: 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  he implementatio
03a0: 6e 20 73 68 6f 77 69 6e 67 20 74 68 72 6f 75 67  n showing throug
03b0: 68 20 69 6e 74 6f 20 74 68 65 0a 69 6e 74 65 72  h into the.inter
03c0: 66 61 63 65 2e 20 20 53 51 4c 69 74 65 20 73 65  face.  SQLite se
03d0: 65 6b 73 20 74 6f 20 6f 76 65 72 63 6f 6d 65 20  eks to overcome 
03e0: 74 68 69 73 20 6d 69 73 66 65 61 74 75 72 65 20  this misfeature 
03f0: 62 79 20 61 6c 6c 6f 77 69 6e 67 0a 79 6f 75 20  by allowing.you 
0400: 74 6f 20 73 74 6f 72 65 20 61 6e 79 20 6b 69 6e  to store any kin
0410: 64 20 6f 66 20 64 61 74 61 20 69 6e 74 6f 20 61  d of data into a
0420: 6e 79 20 6b 69 6e 64 20 6f 66 20 63 6f 6c 75 6d  ny kind of colum
0430: 6e 20 61 6e 64 20 62 79 0a 61 6c 6c 6f 77 69 6e  n and by.allowin
0440: 67 20 66 6c 65 78 69 62 69 6c 69 74 79 20 69 6e  g flexibility in
0450: 20 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69   the specificati
0460: 6f 6e 20 6f 66 20 64 61 74 61 74 79 70 65 73 2e  on of datatypes.
0470: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 64 61 74  .</p>..<p>.A dat
0480: 61 74 79 70 65 20 74 6f 20 53 51 4c 69 74 65 20  atype to SQLite 
0490: 69 73 20 61 6e 79 20 73 65 71 75 65 6e 63 65 20  is any sequence 
04a0: 6f 66 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20  of zero or more 
04b0: 6e 61 6d 65 73 0a 6f 70 74 69 6f 6e 61 6c 6c 79  names.optionally
04c0: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 70   followed by a p
04d0: 61 72 65 6e 74 68 65 73 69 7a 65 64 20 6c 69 73  arenthesized lis
04e0: 74 73 20 6f 66 20 6f 6e 65 20 6f 72 20 74 77 6f  ts of one or two
04f0: 0a 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 73  .signed integers
0500: 2e 20 20 4e 6f 74 69 63 65 20 69 6e 20 70 61 72  .  Notice in par
0510: 74 69 63 75 6c 61 72 20 74 68 61 74 20 61 20 64  ticular that a d
0520: 61 74 61 74 79 70 65 20 6d 61 79 0a 62 65 20 3c  atatype may.be <
0530: 65 6d 3e 7a 65 72 6f 3c 2f 65 6d 3e 20 6f 72 20  em>zero</em> or 
0540: 6d 6f 72 65 20 6e 61 6d 65 73 2e 20 20 54 68 61  more names.  Tha
0550: 74 20 6d 65 61 6e 73 20 74 68 61 74 20 61 6e 20  t means that an 
0560: 65 6d 70 74 79 0a 73 74 72 69 6e 67 20 69 73 20  empty.string is 
0570: 61 20 76 61 6c 69 64 20 64 61 74 61 74 79 70 65  a valid datatype
0580: 20 61 73 20 66 61 72 20 61 73 20 53 51 4c 69 74   as far as SQLit
0590: 65 20 69 73 20 63 6f 6e 63 65 72 6e 65 64 2e 0a  e is concerned..
05a0: 53 6f 20 79 6f 75 20 63 61 6e 20 64 65 63 6c 61  So you can decla
05b0: 72 65 20 74 61 62 6c 65 73 20 77 68 65 72 65 20  re tables where 
05c0: 74 68 65 20 64 61 74 61 74 79 70 65 20 6f 66 20  the datatype of 
05d0: 65 61 63 68 20 63 6f 6c 75 6d 6e 0a 69 73 20 6c  each column.is l
05e0: 65 66 74 20 75 6e 73 70 65 63 69 66 69 65 64 2c  eft unspecified,
05f0: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 3c 2f 70 3e   like this:.</p>
0600: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70  ..<blockquote><p
0610: 72 65 3e 0a 43 52 45 41 54 45 20 54 41 42 4c 45  re>.CREATE TABLE
0620: 20 65 78 31 28 61 2c 62 2c 63 29 3b 0a 3c 2f 70   ex1(a,b,c);.</p
0630: 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  re></blockquote>
0640: 0a 0a 3c 70 3e 0a 45 76 65 6e 20 74 68 6f 75 67  ..<p>.Even thoug
0650: 68 20 53 51 4c 69 74 65 20 61 6c 6c 6f 77 73 20  h SQLite allows 
0660: 74 68 65 20 64 61 74 61 74 79 70 65 20 74 6f 20  the datatype to 
0670: 62 65 20 6f 6d 69 74 74 65 64 2c 20 69 74 20 69  be omitted, it i
0680: 73 0a 73 74 69 6c 6c 20 61 20 67 6f 6f 64 20 69  s.still a good i
0690: 64 65 61 20 74 6f 20 69 6e 63 6c 75 64 65 20 69  dea to include i
06a0: 74 20 69 6e 20 79 6f 75 72 20 43 52 45 41 54 45  t in your CREATE
06b0: 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74   TABLE statement
06c0: 73 2c 0a 73 69 6e 63 65 20 74 68 65 20 64 61 74  s,.since the dat
06d0: 61 20 74 79 70 65 20 6f 66 74 65 6e 20 73 65 72  a type often ser
06e0: 76 65 73 20 61 73 20 61 20 67 6f 6f 64 20 68 69  ves as a good hi
06f0: 6e 74 20 74 6f 20 6f 74 68 65 72 0a 70 72 6f 67  nt to other.prog
0700: 72 61 6d 6d 65 72 73 20 61 62 6f 75 74 20 77 68  rammers about wh
0710: 61 74 20 79 6f 75 20 69 6e 74 65 6e 64 20 74 6f  at you intend to
0720: 20 70 75 74 20 69 6e 20 74 68 65 20 63 6f 6c 75   put in the colu
0730: 6d 6e 2e 20 41 6e 64 0a 69 66 20 79 6f 75 20 65  mn. And.if you e
0740: 76 65 72 20 70 6f 72 74 20 79 6f 75 72 20 63 6f  ver port your co
0750: 64 65 20 74 6f 20 61 6e 6f 74 68 65 72 20 64 61  de to another da
0760: 74 61 62 61 73 65 20 65 6e 67 69 6e 65 2c 20 74  tabase engine, t
0770: 68 61 74 0a 6f 74 68 65 72 20 65 6e 67 69 6e 65  hat.other engine
0780: 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 72   will probably r
0790: 65 71 75 69 72 65 20 61 20 64 61 74 61 74 79 70  equire a datatyp
07a0: 65 20 6f 66 20 73 6f 6d 65 20 6b 69 6e 64 2e 0a  e of some kind..
07b0: 53 51 4c 69 74 65 20 61 63 63 65 70 74 73 20 61  SQLite accepts a
07c0: 6c 6c 20 74 68 65 20 75 73 75 61 6c 20 64 61 74  ll the usual dat
07d0: 61 74 79 70 65 73 2e 20 20 46 6f 72 20 65 78 61  atypes.  For exa
07e0: 6d 70 6c 65 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f  mple:.</p>..<blo
07f0: 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 43 52  ckquote><pre>.CR
0800: 45 41 54 45 20 54 41 42 4c 45 20 65 78 32 28 0a  EATE TABLE ex2(.
0810: 20 20 61 20 56 41 52 43 48 41 52 28 31 30 29 2c    a VARCHAR(10),
0820: 0a 20 20 62 20 4e 56 41 52 43 48 41 52 28 31 35  .  b NVARCHAR(15
0830: 29 2c 0a 20 20 63 20 54 45 58 54 2c 0a 20 20 64  ),.  c TEXT,.  d
0840: 20 49 4e 54 45 47 45 52 2c 0a 20 20 65 20 46 4c   INTEGER,.  e FL
0850: 4f 41 54 2c 0a 20 20 66 20 42 4f 4f 4c 45 41 4e  OAT,.  f BOOLEAN
0860: 2c 0a 20 20 67 20 43 4c 4f 42 2c 0a 20 20 68 20  ,.  g CLOB,.  h 
0870: 42 4c 4f 42 2c 0a 20 20 69 20 54 49 4d 45 53 54  BLOB,.  i TIMEST
0880: 41 4d 50 2c 0a 20 20 6a 20 4e 55 4d 45 52 49 43  AMP,.  j NUMERIC
0890: 28 31 30 2c 35 29 0a 20 20 6b 20 56 41 52 59 49  (10,5).  k VARYI
08a0: 4e 47 20 43 48 41 52 41 43 54 45 52 20 28 32 34  NG CHARACTER (24
08b0: 29 2c 0a 20 20 6c 20 4e 41 54 49 4f 4e 41 4c 20  ),.  l NATIONAL 
08c0: 56 41 52 59 49 4e 47 20 43 48 41 52 41 43 54 45  VARYING CHARACTE
08d0: 52 28 31 36 29 0a 29 3b 0a 3c 2f 70 72 65 3e 3c  R(16).);.</pre><
08e0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70  /blockquote>..<p
08f0: 3e 0a 41 6e 64 20 73 6f 20 66 6f 72 74 68 2e 20  >.And so forth. 
0900: 20 42 61 73 69 63 61 6c 6c 79 20 61 6e 79 20 73   Basically any s
0910: 65 71 75 65 6e 63 65 20 6f 66 20 6e 61 6d 65 73  equence of names
0920: 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 66 6f 6c 6c   optionally foll
0930: 6f 77 65 64 20 62 79 20 0a 6f 6e 65 20 6f 72 20  owed by .one or 
0940: 74 77 6f 20 73 69 67 6e 65 64 20 69 6e 74 65 67  two signed integ
0950: 65 72 73 20 69 6e 20 70 61 72 65 6e 74 68 65 73  ers in parenthes
0960: 65 73 20 77 69 6c 6c 20 64 6f 2e 0a 3c 2f 70 3e  es will do..</p>
0970: 0a 0a 3c 68 32 3e 32 2e 30 20 26 6e 62 73 70 3b  ..<h2>2.0 &nbsp;
0980: 20 54 68 65 20 49 4e 54 45 47 45 52 20 50 52 49   The INTEGER PRI
0990: 4d 41 52 59 20 4b 45 59 3c 2f 68 32 3e 0a 0a 3c  MARY KEY</h2>..<
09a0: 70 3e 0a 4f 6e 65 20 65 78 63 65 70 74 69 6f 6e  p>.One exception
09b0: 20 74 6f 20 74 68 65 20 74 79 70 65 6c 65 73 73   to the typeless
09c0: 6e 65 73 73 20 6f 66 20 53 51 4c 69 74 65 20 69  ness of SQLite i
09d0: 73 20 61 20 63 6f 6c 75 6d 6e 20 77 68 6f 73 65  s a column whose
09e0: 20 74 79 70 65 0a 69 73 20 49 4e 54 45 47 45 52   type.is INTEGER
09f0: 20 50 52 49 4d 41 52 59 20 4b 45 59 2e 20 20 28   PRIMARY KEY.  (
0a00: 41 6e 64 20 79 6f 75 20 6d 75 73 74 20 75 73 65  And you must use
0a10: 20 22 49 4e 54 45 47 45 52 22 20 6e 6f 74 20 22   "INTEGER" not "
0a20: 49 4e 54 22 2e 0a 41 20 63 6f 6c 75 6d 6e 20 6f  INT"..A column o
0a30: 66 20 74 79 70 65 20 49 4e 54 20 50 52 49 4d 41  f type INT PRIMA
0a40: 52 59 20 4b 45 59 20 69 73 20 74 79 70 65 6c 65  RY KEY is typele
0a50: 73 73 20 6a 75 73 74 20 6c 69 6b 65 20 61 6e 79  ss just like any
0a60: 20 6f 74 68 65 72 2e 29 0a 49 4e 54 45 47 45 52   other.).INTEGER
0a70: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c   PRIMARY KEY col
0a80: 75 6d 6e 73 20 6d 75 73 74 20 63 6f 6e 74 61 69  umns must contai
0a90: 6e 20 61 20 33 32 2d 62 69 74 20 73 69 67 6e 65  n a 32-bit signe
0aa0: 64 20 69 6e 74 65 67 65 72 2e 20 20 41 6e 79 0a  d integer.  Any.
0ab0: 61 74 74 65 6d 70 74 20 74 6f 20 69 6e 73 65 72  attempt to inser
0ac0: 74 20 6e 6f 6e 2d 69 6e 74 65 67 65 72 20 64 61  t non-integer da
0ad0: 74 61 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69  ta will result i
0ae0: 6e 20 61 6e 20 65 72 72 6f 72 2e 0a 3c 2f 70 3e  n an error..</p>
0af0: 0a 0a 3c 70 3e 0a 49 4e 54 45 47 45 52 20 50 52  ..<p>.INTEGER PR
0b00: 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e  IMARY KEY column
0b10: 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  s can be used to
0b20: 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 65   implement the e
0b30: 71 75 69 76 61 6c 65 6e 74 0a 6f 66 20 41 55 54  quivalent.of AUT
0b40: 4f 49 4e 43 52 45 4d 45 4e 54 2e 20 20 49 66 20  OINCREMENT.  If 
0b50: 79 6f 75 20 74 72 79 20 74 6f 20 69 6e 73 65 72  you try to inser
0b60: 74 20 61 20 4e 55 4c 4c 20 69 6e 74 6f 20 61 6e  t a NULL into an
0b70: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
0b80: 0a 4b 45 59 20 63 6f 6c 75 6d 6e 2c 20 74 68 65  .KEY column, the
0b90: 20 63 6f 6c 75 6d 6e 20 77 69 6c 6c 20 61 63 74   column will act
0ba0: 75 61 6c 6c 79 20 62 65 20 66 69 6c 6c 65 64 20  ually be filled 
0bb0: 77 69 74 68 20 61 20 69 6e 74 65 67 65 72 20 74  with a integer t
0bc0: 68 61 74 20 69 73 0a 6f 6e 65 20 67 72 65 61 74  hat is.one great
0bd0: 65 72 20 74 68 61 6e 20 74 68 65 20 6c 61 72 67  er than the larg
0be0: 65 73 74 20 6b 65 79 20 61 6c 72 65 61 64 79 20  est key already 
0bf0: 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 20 4f  in the table.  O
0c00: 72 20 69 66 20 74 68 65 0a 6c 61 72 67 65 73 74  r if the.largest
0c10: 20 6b 65 79 20 69 73 20 32 31 34 37 34 38 33 36   key is 21474836
0c20: 34 37 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6c  47, then the col
0c30: 75 6d 6e 20 77 69 6c 6c 20 62 65 20 66 69 6c 6c  umn will be fill
0c40: 65 64 20 77 69 74 68 20 61 0a 72 61 6e 64 6f 6d  ed with a.random
0c50: 20 69 6e 74 65 67 65 72 2e 20 20 45 69 74 68 65   integer.  Eithe
0c60: 72 20 77 61 79 2c 20 74 68 65 20 49 4e 54 45 47  r way, the INTEG
0c70: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63  ER PRIMARY KEY c
0c80: 6f 6c 75 6d 6e 20 77 69 6c 6c 20 62 65 0a 61 73  olumn will be.as
0c90: 73 69 67 6e 65 64 20 61 20 75 6e 69 71 75 65 20  signed a unique 
0ca0: 69 6e 74 65 67 65 72 2e 20 20 59 6f 75 20 63 61  integer.  You ca
0cb0: 6e 20 72 65 74 72 69 65 76 65 20 74 68 69 73 20  n retrieve this 
0cc0: 69 6e 74 65 67 65 72 20 75 73 69 6e 67 0a 74 68  integer using.th
0cd0: 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6c 61 73 74  e <b>sqlite_last
0ce0: 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29 3c  _insert_rowid()<
0cf0: 2f 62 3e 20 41 50 49 20 66 75 6e 63 74 69 6f 6e  /b> API function
0d00: 20 6f 72 20 75 73 69 6e 67 20 74 68 65 0a 3c 62   or using the.<b
0d10: 3e 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77  >last_insert_row
0d20: 69 64 28 29 3c 2f 62 3e 20 53 51 4c 20 66 75 6e  id()</b> SQL fun
0d30: 63 74 69 6f 6e 20 69 6e 20 61 20 73 75 62 73 65  ction in a subse
0d40: 71 75 65 6e 74 20 53 45 4c 45 43 54 20 73 74 61  quent SELECT sta
0d50: 74 65 6d 65 6e 74 2e 0a 3c 2f 70 3e 0a 0a 3c 68  tement..</p>..<h
0d60: 32 3e 33 2e 30 20 26 6e 62 73 70 3b 20 43 6f 6d  2>3.0 &nbsp; Com
0d70: 70 61 72 69 73 6f 6e 20 61 6e 64 20 53 6f 72 74  parison and Sort
0d80: 20 4f 72 64 65 72 3c 2f 68 32 3e 0a 0a 3c 70 3e   Order</h2>..<p>
0d90: 0a 53 51 4c 69 74 65 20 69 73 20 74 79 70 65 6c  .SQLite is typel
0da0: 65 73 73 20 66 6f 72 20 74 68 65 20 70 75 72 70  ess for the purp
0db0: 6f 73 65 20 6f 66 20 64 65 63 69 64 69 6e 67 20  ose of deciding 
0dc0: 77 68 61 74 20 64 61 74 61 20 69 73 20 61 6c 6c  what data is all
0dd0: 6f 77 65 64 0a 74 6f 20 62 65 20 73 74 6f 72 65  owed.to be store
0de0: 64 20 69 6e 20 61 20 63 6f 6c 75 6d 6e 2e 20 20  d in a column.  
0df0: 42 75 74 20 73 6f 6d 65 20 6e 6f 74 69 6f 6e 20  But some notion 
0e00: 6f 66 20 74 79 70 65 20 63 6f 6d 65 73 20 69 6e  of type comes in
0e10: 74 6f 20 70 6c 61 79 0a 77 68 65 6e 20 73 6f 72  to play.when sor
0e20: 74 69 6e 67 20 61 6e 64 20 63 6f 6d 70 61 72 69  ting and compari
0e30: 6e 67 20 64 61 74 61 2e 20 20 46 6f 72 20 74 68  ng data.  For th
0e40: 65 73 65 20 70 75 72 70 6f 73 65 73 2c 20 61 20  ese purposes, a 
0e50: 63 6f 6c 75 6d 6e 20 6f 72 0a 61 6e 20 65 78 70  column or.an exp
0e60: 72 65 73 73 69 6f 6e 20 63 61 6e 20 62 65 20 6f  ression can be o
0e70: 6e 65 20 6f 66 20 74 77 6f 20 74 79 70 65 73 3a  ne of two types:
0e80: 20 3c 62 3e 6e 75 6d 65 72 69 63 3c 2f 62 3e 20   <b>numeric</b> 
0e90: 61 6e 64 20 3c 62 3e 74 65 78 74 3c 2f 62 3e 2e  and <b>text</b>.
0ea0: 0a 54 68 65 20 73 6f 72 74 20 6f 72 20 63 6f 6d  .The sort or com
0eb0: 70 61 72 69 73 6f 6e 20 6d 61 79 20 67 69 76 65  parison may give
0ec0: 20 64 69 66 66 65 72 65 6e 74 20 72 65 73 75 6c   different resul
0ed0: 74 73 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20  ts depending on 
0ee0: 77 68 69 63 68 0a 74 79 70 65 20 6f 66 20 64 61  which.type of da
0ef0: 74 61 20 69 73 20 62 65 69 6e 67 20 73 6f 72 74  ta is being sort
0f00: 65 64 20 6f 72 20 63 6f 6d 70 61 72 65 64 2e 0a  ed or compared..
0f10: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 49 66 20 64 61 74  </p>..<p>.If dat
0f20: 61 20 69 73 20 6f 66 20 74 79 70 65 20 3c 62 3e  a is of type <b>
0f30: 74 65 78 74 3c 2f 62 3e 20 74 68 65 6e 20 74 68  text</b> then th
0f40: 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 69 73 20  e comparison is 
0f50: 64 65 74 65 72 6d 69 6e 65 64 20 62 79 0a 74 68  determined by.th
0f60: 65 20 73 74 61 6e 64 61 72 64 20 43 20 64 61 74  e standard C dat
0f70: 61 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 75 6e  a comparison fun
0f80: 63 74 69 6f 6e 73 20 3c 62 3e 6d 65 6d 63 6d 70  ctions <b>memcmp
0f90: 28 29 3c 2f 62 3e 20 6f 72 0a 3c 62 3e 73 74 72  ()</b> or.<b>str
0fa0: 63 6d 70 28 29 3c 2f 62 3e 2e 20 20 54 68 65 20  cmp()</b>.  The 
0fb0: 63 6f 6d 70 61 72 69 73 6f 6e 20 6c 6f 6f 6b 73  comparison looks
0fc0: 20 61 74 20 62 79 74 65 73 20 66 72 6f 6d 20 74   at bytes from t
0fd0: 77 6f 20 69 6e 70 75 74 73 20 6f 6e 65 0a 62 79  wo inputs one.by
0fe0: 20 6f 6e 65 20 61 6e 64 20 72 65 74 75 72 6e 73   one and returns
0ff0: 20 74 68 65 20 66 69 72 73 74 20 6e 6f 6e 2d 7a   the first non-z
1000: 65 72 6f 20 64 69 66 66 65 72 65 6e 63 65 2e 0a  ero difference..
1010: 53 74 72 69 6e 67 73 20 61 72 65 20 27 5c 30 30  Strings are '\00
1020: 30 27 20 74 65 72 6d 69 6e 61 74 65 64 20 73 6f  0' terminated so
1030: 20 73 68 6f 72 74 65 72 0a 73 74 72 69 6e 67 73   shorter.strings
1040: 20 73 6f 72 74 20 62 65 66 6f 72 65 20 6c 6f 6e   sort before lon
1050: 67 65 72 20 73 74 72 69 6e 67 73 2c 20 61 73 20  ger strings, as 
1060: 79 6f 75 20 77 6f 75 6c 64 20 65 78 70 65 63 74  you would expect
1070: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 46 6f 72 20  ..</p>..<p>.For 
1080: 6e 75 6d 65 72 69 63 20 64 61 74 61 2c 20 74 68  numeric data, th
1090: 69 73 20 73 69 74 75 61 74 69 6f 6e 20 69 73 20  is situation is 
10a0: 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 2e 20 20 49  more complex.  I
10b0: 66 20 62 6f 74 68 20 69 6e 70 75 74 73 0a 6c 6f  f both inputs.lo
10c0: 6f 6b 20 6c 69 6b 65 20 77 65 6c 6c 2d 66 6f 72  ok like well-for
10d0: 6d 65 64 20 6e 75 6d 62 65 72 73 2c 20 74 68 65  med numbers, the
10e0: 6e 20 74 68 65 79 20 61 72 65 20 63 6f 6e 76 65  n they are conve
10f0: 72 74 65 64 0a 69 6e 74 6f 20 66 6c 6f 61 74 69  rted.into floati
1100: 6e 67 20 70 6f 69 6e 74 20 76 61 6c 75 65 73 20  ng point values 
1110: 75 73 69 6e 67 20 3c 62 3e 61 74 6f 66 28 29 3c  using <b>atof()<
1120: 2f 62 3e 20 61 6e 64 20 63 6f 6d 70 61 72 65 64  /b> and compared
1130: 20 6e 75 6d 65 72 69 63 61 6c 6c 79 2e 0a 49 66   numerically..If
1140: 20 6f 6e 65 20 69 6e 70 75 74 20 69 73 20 6e 6f   one input is no
1150: 74 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20  t a well-formed 
1160: 6e 75 6d 62 65 72 20 62 75 74 20 74 68 65 20 6f  number but the o
1170: 74 68 65 72 20 69 73 2c 20 74 68 65 6e 20 74 68  ther is, then th
1180: 65 0a 6e 75 6d 62 65 72 20 69 73 20 63 6f 6e 73  e.number is cons
1190: 69 64 65 72 65 64 20 74 6f 20 62 65 20 6c 65 73  idered to be les
11a0: 73 20 74 68 61 6e 20 74 68 65 20 6e 6f 6e 2d 6e  s than the non-n
11b0: 75 6d 62 65 72 2e 20 20 49 66 20 6e 65 69 74 68  umber.  If neith
11c0: 65 72 20 69 6e 70 75 74 73 0a 69 73 20 61 20 77  er inputs.is a w
11d0: 65 6c 6c 2d 66 6f 72 6d 65 64 20 6e 75 6d 62 65  ell-formed numbe
11e0: 72 2c 20 74 68 65 6e 20 3c 62 3e 73 74 72 63 6d  r, then <b>strcm
11f0: 70 28 29 3c 2f 62 3e 20 69 73 20 75 73 65 64 20  p()</b> is used 
1200: 74 6f 20 64 6f 20 74 68 65 0a 63 6f 6d 70 61 72  to do the.compar
1210: 69 73 6f 6e 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  ison..</p>..<p>.
1220: 44 6f 20 6e 6f 74 20 62 65 20 63 6f 6e 66 75 73  Do not be confus
1230: 65 64 20 62 79 20 74 68 65 20 66 61 63 74 20 74  ed by the fact t
1240: 68 61 74 20 61 20 63 6f 6c 75 6d 6e 20 6d 69 67  hat a column mig
1250: 68 74 20 68 61 76 65 20 61 20 22 6e 75 6d 65 72  ht have a "numer
1260: 69 63 22 0a 64 61 74 61 74 79 70 65 2e 20 20 54  ic".datatype.  T
1270: 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 6d 65 61  his does not mea
1280: 6e 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 6d  n that the colum
1290: 6e 20 63 61 6e 20 63 6f 6e 74 61 69 6e 20 6f 6e  n can contain on
12a0: 6c 79 20 6e 75 6d 62 65 72 73 2e 0a 49 74 20 6d  ly numbers..It m
12b0: 65 72 65 6c 79 20 6d 65 61 6e 73 20 74 68 61 74  erely means that
12c0: 20 69 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64   if the column d
12d0: 6f 65 73 20 63 6f 6e 74 61 69 6e 20 61 20 6e 75  oes contain a nu
12e0: 6d 62 65 72 2c 20 74 68 61 74 20 6e 75 6d 62 65  mber, that numbe
12f0: 72 0a 77 69 6c 6c 20 73 6f 72 74 20 69 6e 20 6e  r.will sort in n
1300: 75 6d 65 72 69 63 61 6c 20 6f 72 64 65 72 2e 0a  umerical order..
1310: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 46 6f 72 20 62 6f  </p>..<p>.For bo
1320: 74 68 20 74 65 78 74 20 61 6e 64 20 6e 75 6d 65  th text and nume
1330: 72 69 63 20 76 61 6c 75 65 73 2c 20 4e 55 4c 4c  ric values, NULL
1340: 20 73 6f 72 74 73 20 62 65 66 6f 72 65 20 61 6e   sorts before an
1350: 79 20 6f 74 68 65 72 20 76 61 6c 75 65 2e 0a 41  y other value..A
1360: 20 63 6f 6d 70 61 72 69 73 6f 6e 20 6f 66 20 61   comparison of a
1370: 6e 79 20 76 61 6c 75 65 20 61 67 61 69 6e 73 74  ny value against
1380: 20 4e 55 4c 4c 20 75 73 69 6e 67 20 6f 70 65 72   NULL using oper
1390: 61 74 6f 72 73 20 6c 69 6b 65 20 22 26 6c 74 3b  ators like "&lt;
13a0: 22 20 6f 72 0a 22 26 67 74 3b 3d 22 20 69 73 20  " or."&gt;=" is 
13b0: 61 6c 77 61 79 73 20 66 61 6c 73 65 2e 0a 3c 2f  always false..</
13c0: 70 3e 0a 0a 3c 68 32 3e 34 2e 30 20 26 6e 62 73  p>..<h2>4.0 &nbs
13d0: 70 3b 20 48 6f 77 20 53 51 4c 69 74 65 20 44 65  p; How SQLite De
13e0: 74 65 72 6d 69 6e 65 73 20 44 61 74 61 74 79 70  termines Datatyp
13f0: 65 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 46 6f 72  es</h2>..<p>.For
1400: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
1410: 32 2e 36 2e 33 20 61 6e 64 20 65 61 72 6c 69 65  2.6.3 and earlie
1420: 72 2c 20 61 6c 6c 20 76 61 6c 75 65 73 20 75 73  r, all values us
1430: 65 64 20 74 68 65 20 6e 75 6d 65 72 69 63 20 64  ed the numeric d
1440: 61 74 61 74 79 70 65 2e 0a 54 68 65 20 74 65 78  atatype..The tex
1450: 74 20 64 61 74 61 74 79 70 65 20 61 70 70 65 61  t datatype appea
1460: 72 73 20 69 6e 20 76 65 72 73 69 6f 6e 20 32 2e  rs in version 2.
1470: 37 2e 30 20 61 6e 64 20 6c 61 74 65 72 2e 20 20  7.0 and later.  
1480: 49 6e 20 74 68 65 20 73 65 71 75 65 6c 20 69 74  In the sequel it
1490: 0a 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74  .is assumed that
14a0: 20 79 6f 75 20 61 72 65 20 75 73 69 6e 67 20 76   you are using v
14b0: 65 72 73 69 6f 6e 20 32 2e 37 2e 30 20 6f 72 20  ersion 2.7.0 or 
14c0: 6c 61 74 65 72 20 6f 66 20 53 51 4c 69 74 65 2e  later of SQLite.
14d0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 46 6f 72 20 61  .</p>..<p>.For a
14e0: 6e 20 65 78 70 72 65 73 73 69 6f 6e 2c 20 74 68  n expression, th
14f0: 65 20 64 61 74 61 74 79 70 65 20 6f 66 20 74 68  e datatype of th
1500: 65 20 72 65 73 75 6c 74 20 69 73 20 6f 66 74 65  e result is ofte
1510: 6e 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 0a  n determined by.
1520: 74 68 65 20 6f 75 74 65 72 6d 6f 73 74 20 6f 70  the outermost op
1530: 65 72 61 74 6f 72 2e 20 20 46 6f 72 20 65 78 61  erator.  For exa
1540: 6d 70 6c 65 2c 20 61 72 69 74 68 6d 61 74 69 63  mple, arithmatic
1550: 20 6f 70 65 72 61 74 6f 72 73 20 28 22 2b 22 2c   operators ("+",
1560: 20 22 2a 22 2c 20 22 25 22 29 0a 61 6c 77 61 79   "*", "%").alway
1570: 73 20 72 65 74 75 72 6e 20 61 20 6e 75 6d 65 72  s return a numer
1580: 69 63 20 72 65 73 75 6c 74 73 2e 20 20 54 68 65  ic results.  The
1590: 20 73 74 72 69 6e 67 20 63 6f 6e 63 61 74 65 6e   string concaten
15a0: 61 74 69 6f 6e 20 6f 70 65 72 61 74 6f 72 0a 28  ation operator.(
15b0: 22 7c 7c 22 29 20 72 65 74 75 72 6e 73 20 61 20  "||") returns a 
15c0: 74 65 78 74 20 72 65 73 75 6c 74 2e 20 20 41 6e  text result.  An
15d0: 64 20 73 6f 20 66 6f 72 74 68 2e 20 20 49 66 20  d so forth.  If 
15e0: 79 6f 75 20 61 72 65 20 65 76 65 72 20 69 6e 20  you are ever in 
15f0: 64 6f 75 62 74 0a 61 62 6f 75 74 20 74 68 65 20  doubt.about the 
1600: 64 61 74 61 74 79 70 65 20 6f 66 20 61 6e 20 65  datatype of an e
1610: 78 70 72 65 73 73 69 6f 6e 20 79 6f 75 20 63 61  xpression you ca
1620: 6e 20 75 73 65 20 74 68 65 20 73 70 65 63 69 61  n use the specia
1630: 6c 20 3c 62 3e 74 79 70 65 6f 66 28 29 3c 2f 62  l <b>typeof()</b
1640: 3e 0a 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 74  >.SQL function t
1650: 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 68 61 74  o determine what
1660: 20 74 68 65 20 64 61 74 61 74 79 70 65 20 69 73   the datatype is
1670: 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a  .  For example:.
1680: 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74  </p>..<blockquot
1690: 65 3e 3c 70 72 65 3e 0a 73 71 6c 69 74 65 26 67  e><pre>.sqlite&g
16a0: 74 3b 20 53 45 4c 45 43 54 20 74 79 70 65 6f 66  t; SELECT typeof
16b0: 28 27 61 62 63 27 2b 31 32 33 29 3b 0a 6e 75 6d  ('abc'+123);.num
16c0: 65 72 69 63 0a 73 71 6c 69 74 65 26 67 74 3b 20  eric.sqlite&gt; 
16d0: 53 45 4c 45 43 54 20 74 79 70 65 6f 66 28 27 61  SELECT typeof('a
16e0: 62 63 27 7c 7c 31 32 33 29 3b 0a 74 65 78 74 0a  bc'||123);.text.
16f0: 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f  </pre></blockquo
1700: 74 65 3e 0a 0a 3c 70 3e 0a 46 6f 72 20 74 61 62  te>..<p>.For tab
1710: 6c 65 20 63 6f 6c 75 6d 6e 73 2c 20 74 68 65 20  le columns, the 
1720: 64 61 74 61 74 79 70 65 20 69 73 20 64 65 74 65  datatype is dete
1730: 72 6d 69 6e 65 64 20 62 79 20 74 68 65 20 74 79  rmined by the ty
1740: 70 65 20 64 65 63 6c 61 72 61 74 69 6f 6e 0a 6f  pe declaration.o
1750: 66 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42  f the CREATE TAB
1760: 4c 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 54  LE statement.  T
1770: 68 65 20 64 61 74 61 74 79 70 65 20 69 73 20 74  he datatype is t
1780: 65 78 74 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20  ext if and only 
1790: 69 66 0a 74 68 65 20 74 79 70 65 20 64 65 63 6c  if.the type decl
17a0: 61 72 61 74 69 6f 6e 20 63 6f 6e 74 61 69 6e 73  aration contains
17b0: 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20   one or more of 
17c0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74  the following st
17d0: 72 69 6e 67 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c  rings:.</p>..<bl
17e0: 6f 63 6b 71 75 6f 74 65 3e 0a 42 4c 4f 42 3c 62  ockquote>.BLOB<b
17f0: 72 3e 0a 43 48 41 52 3c 62 72 3e 0a 43 4c 4f 42  r>.CHAR<br>.CLOB
1800: 3c 2f 62 72 3e 0a 54 45 58 54 0a 3c 2f 62 6c 6f  </br>.TEXT.</blo
1810: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68  ckquote>..<p>.Th
1820: 65 20 73 65 61 72 63 68 20 66 6f 72 20 74 68 65  e search for the
1830: 73 65 20 73 74 72 69 6e 67 73 20 69 6e 20 74 68  se strings in th
1840: 65 20 74 79 70 65 20 64 65 63 6c 61 72 61 74 69  e type declarati
1850: 6f 6e 20 69 73 20 63 61 73 65 20 69 6e 73 65 6e  on is case insen
1860: 73 69 74 69 76 65 2c 0a 6f 66 20 63 6f 75 72 73  sitive,.of cours
1870: 65 2e 20 20 49 66 20 61 6e 79 20 6f 66 20 74 68  e.  If any of th
1880: 65 20 61 62 6f 76 65 20 73 74 72 69 6e 67 73 20  e above strings 
1890: 6f 63 63 75 72 20 61 6e 79 77 68 65 72 65 20 69  occur anywhere i
18a0: 6e 20 74 68 65 20 74 79 70 65 0a 64 65 63 6c 61  n the type.decla
18b0: 72 61 74 69 6f 6e 2c 20 74 68 65 6e 20 74 68 65  ration, then the
18c0: 20 64 61 74 61 74 79 70 65 20 6f 66 20 74 68 65   datatype of the
18d0: 20 63 6f 6c 75 6d 6e 20 69 73 20 74 65 78 74 2e   column is text.
18e0: 20 20 4e 6f 74 69 63 65 20 74 68 61 74 0a 74 68    Notice that.th
18f0: 65 20 74 79 70 65 20 22 56 41 52 43 48 41 52 22  e type "VARCHAR"
1900: 20 63 6f 6e 74 61 69 6e 73 20 22 43 48 41 52 22   contains "CHAR"
1910: 20 61 73 20 61 20 73 75 62 73 74 72 69 6e 67 20   as a substring 
1920: 73 6f 20 69 74 20 69 73 20 63 6f 6e 73 69 64 65  so it is conside
1930: 72 65 64 0a 74 65 78 74 2e 3c 2f 70 3e 0a 0a 3c  red.text.</p>..<
1940: 70 3e 49 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65  p>If none of the
1950: 20 73 74 72 69 6e 67 73 20 61 62 6f 76 65 20 6f   strings above o
1960: 63 63 75 72 20 61 6e 79 77 68 65 72 65 20 69 6e  ccur anywhere in
1970: 20 74 68 65 20 74 79 70 65 20 64 65 63 6c 61 72   the type declar
1980: 61 74 69 6f 6e 2c 0a 74 68 65 6e 20 74 68 65 20  ation,.then the 
1990: 64 61 74 61 74 79 70 65 20 69 73 20 6e 75 6d 65  datatype is nume
19a0: 72 69 63 2e 20 20 4e 6f 74 65 20 69 6e 20 70 61  ric.  Note in pa
19b0: 72 74 69 63 75 6c 61 72 20 74 68 61 74 20 74 68  rticular that th
19c0: 65 20 64 61 74 61 74 79 70 65 20 66 6f 72 20 63  e datatype for c
19d0: 6f 6c 75 6d 6e 73 0a 77 69 74 68 20 61 6e 20 65  olumns.with an e
19e0: 6d 70 74 79 20 74 79 70 65 20 64 65 63 6c 61 72  mpty type declar
19f0: 61 74 69 6f 6e 20 69 73 20 6e 75 6d 65 72 69 63  ation is numeric
1a00: 2e 0a 3c 2f 70 3e 0a 0a 3c 68 32 3e 35 2e 30 20  ..</p>..<h2>5.0 
1a10: 26 6e 62 73 70 3b 20 45 78 61 6d 70 6c 65 73 3c  &nbsp; Examples<
1a20: 2f 68 32 3e 0a 0a 3c 70 3e 0a 43 6f 6e 73 69 64  /h2>..<p>.Consid
1a30: 65 72 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  er the following
1a40: 20 74 77 6f 20 63 6f 6d 6d 61 6e 64 20 73 65 71   two command seq
1a50: 75 65 6e 63 65 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62  uences:.</p>..<b
1a60: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a  lockquote><pre>.
1a70: 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 31 28  CREATE TABLE t1(
1a80: 61 20 49 4e 54 45 47 45 52 20 55 4e 49 51 55 45  a INTEGER UNIQUE
1a90: 29 3b 20 20 20 20 20 20 20 20 43 52 45 41 54 45  );        CREATE
1aa0: 20 54 41 42 4c 45 20 74 32 28 62 20 54 45 58 54   TABLE t2(b TEXT
1ab0: 20 55 4e 49 51 55 45 29 3b 0a 49 4e 53 45 52 54   UNIQUE);.INSERT
1ac0: 20 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53 28   INTO t1 VALUES(
1ad0: 27 30 27 29 3b 20 20 20 20 20 20 20 20 20 20 20  '0');           
1ae0: 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20      INSERT INTO 
1af0: 74 32 20 56 41 4c 55 45 53 28 30 29 3b 0a 49 4e  t2 VALUES(0);.IN
1b00: 53 45 52 54 20 49 4e 54 4f 20 74 31 20 56 41 4c  SERT INTO t1 VAL
1b10: 55 45 53 28 27 30 2e 30 27 29 3b 20 20 20 20 20  UES('0.0');     
1b20: 20 20 20 20 20 20 20 20 49 4e 53 45 52 54 20 49          INSERT I
1b30: 4e 54 4f 20 74 32 20 56 41 4c 55 45 53 28 30 2e  NTO t2 VALUES(0.
1b40: 30 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63  0);.</pre></bloc
1b50: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 49 6e 20 74  kquote>..<p>In t
1b60: 68 65 20 73 65 71 75 65 6e 63 65 20 6f 6e 20 74  he sequence on t
1b70: 68 65 20 6c 65 66 74 2c 20 74 68 65 20 73 65 63  he left, the sec
1b80: 6f 6e 64 20 69 6e 73 65 72 74 20 77 69 6c 6c 20  ond insert will 
1b90: 66 61 69 6c 2e 20 20 49 6e 20 74 68 69 73 20 63  fail.  In this c
1ba0: 61 73 65 2c 0a 74 68 65 20 73 74 72 69 6e 67 73  ase,.the strings
1bb0: 20 27 30 27 20 61 6e 64 20 27 30 2e 30 27 20 61   '0' and '0.0' a
1bc0: 72 65 20 74 72 65 61 74 65 64 20 61 73 20 6e 75  re treated as nu
1bd0: 6d 62 65 72 73 20 73 69 6e 63 65 20 74 68 65 79  mbers since they
1be0: 20 61 72 65 20 62 65 69 6e 67 20 0a 69 6e 73 65   are being .inse
1bf0: 72 74 65 64 20 69 6e 74 6f 20 61 20 6e 75 6d 65  rted into a nume
1c00: 72 69 63 20 63 6f 6c 75 6d 6e 20 62 75 74 20 30  ric column but 0
1c10: 3d 3d 30 2e 30 20 77 68 69 63 68 20 76 69 6f 6c  ==0.0 which viol
1c20: 61 74 65 73 20 74 68 65 20 75 6e 69 71 75 65 6e  ates the uniquen
1c30: 65 73 73 0a 63 6f 6e 73 74 72 61 69 6e 74 2e 20  ess.constraint. 
1c40: 20 48 6f 77 65 76 65 72 2c 20 74 68 65 20 73 65   However, the se
1c50: 63 6f 6e 64 20 69 6e 73 65 72 74 20 69 6e 20 74  cond insert in t
1c60: 68 65 20 72 69 67 68 74 2d 68 61 6e 64 20 73 65  he right-hand se
1c70: 71 75 65 6e 63 65 20 77 6f 72 6b 73 2e 20 20 49  quence works.  I
1c80: 6e 0a 74 68 69 73 20 63 61 73 65 2c 20 74 68 65  n.this case, the
1c90: 20 63 6f 6e 73 74 61 6e 74 73 20 30 20 61 6e 64   constants 0 and
1ca0: 20 30 2e 30 20 61 72 65 20 74 72 65 61 74 65 64   0.0 are treated
1cb0: 20 61 20 73 74 72 69 6e 67 73 20 77 68 69 63 68   a strings which
1cc0: 20 6d 65 61 6e 73 20 74 68 61 74 0a 74 68 65 79   means that.they
1cd0: 20 61 72 65 20 64 69 73 74 69 6e 63 74 2e 3c 2f   are distinct.</
1ce0: 70 3e 0a 0a 3c 70 3e 53 51 4c 69 74 65 20 61 6c  p>..<p>SQLite al
1cf0: 77 61 79 73 20 63 6f 6e 76 65 72 74 73 20 6e 75  ways converts nu
1d00: 6d 62 65 72 73 20 69 6e 74 6f 20 64 6f 75 62 6c  mbers into doubl
1d10: 65 2d 70 72 65 63 69 73 69 6f 6e 20 28 36 34 2d  e-precision (64-
1d20: 62 69 74 29 20 66 6c 6f 61 74 73 0a 66 6f 72 20  bit) floats.for 
1d30: 63 6f 6d 70 61 72 69 73 6f 6e 20 70 75 72 70 6f  comparison purpo
1d40: 73 65 73 2e 20 20 54 68 69 73 20 6d 65 61 6e 73  ses.  This means
1d50: 20 74 68 61 74 20 61 20 6c 6f 6e 67 20 73 65 71   that a long seq
1d60: 75 65 6e 63 65 20 6f 66 20 64 69 67 69 74 73 20  uence of digits 
1d70: 74 68 61 74 0a 64 69 66 66 65 72 20 6f 6e 6c 79  that.differ only
1d80: 20 69 6e 20 69 6e 73 69 67 6e 69 66 69 63 61 6e   in insignifican
1d90: 74 20 64 69 67 69 74 73 20 77 69 6c 6c 20 63 6f  t digits will co
1da0: 6d 70 61 72 65 20 65 71 75 61 6c 20 69 66 20 74  mpare equal if t
1db0: 68 65 79 0a 61 72 65 20 69 6e 20 61 20 6e 75 6d  hey.are in a num
1dc0: 65 72 69 63 20 63 6f 6c 75 6d 6e 20 62 75 74 20  eric column but 
1dd0: 77 69 6c 6c 20 63 6f 6d 70 61 72 65 20 75 6e 65  will compare une
1de0: 71 75 61 6c 20 69 66 20 74 68 65 79 20 61 72 65  qual if they are
1df0: 20 69 6e 20 61 20 74 65 78 74 0a 63 6f 6c 75 6d   in a text.colum
1e00: 6e 2e 20 20 57 65 20 68 61 76 65 3a 3c 2f 70 3e  n.  We have:</p>
1e10: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70  ..<blockquote><p
1e20: 72 65 3e 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20  re>.INSERT INTO 
1e30: 74 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t1              
1e40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 4e                IN
1e50: 53 45 52 54 20 49 4e 54 4f 20 74 32 0a 20 20 20  SERT INTO t2.   
1e60: 56 41 4c 55 45 53 28 27 31 32 33 34 35 36 37 38  VALUES('12345678
1e70: 39 30 31 32 33 34 35 36 37 38 39 30 27 29 3b 20  901234567890'); 
1e80: 20 20 20 20 20 20 20 20 20 20 56 41 4c 55 45 53            VALUES
1e90: 28 31 32 33 34 35 36 37 38 39 30 31 32 33 34 35  (123456789012345
1ea0: 36 37 38 39 30 29 3b 0a 49 4e 53 45 52 54 20 49  67890);.INSERT I
1eb0: 4e 54 4f 20 74 31 20 20 20 20 20 20 20 20 20 20  NTO t1          
1ec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ed0: 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 32    INSERT INTO t2
1ee0: 0a 20 20 20 56 41 4c 55 45 53 28 27 31 32 33 34  .   VALUES('1234
1ef0: 35 36 37 38 39 30 31 32 33 34 35 36 37 38 39 31  5678901234567891
1f00: 27 29 3b 20 20 20 20 20 20 20 20 20 20 20 56 41  ');           VA
1f10: 4c 55 45 53 28 31 32 33 34 35 36 37 38 39 30 31  LUES(12345678901
1f20: 32 33 34 35 36 37 38 39 31 29 3b 0a 3c 2f 70 72  234567891);.</pr
1f30: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
1f40: 0a 3c 70 3e 41 73 20 62 65 66 6f 72 65 2c 20 74  .<p>As before, t
1f50: 68 65 20 73 65 63 6f 6e 64 20 69 6e 73 65 72 74  he second insert
1f60: 20 6f 6e 20 74 68 65 20 6c 65 66 74 20 77 69 6c   on the left wil
1f70: 6c 20 66 61 69 6c 20 62 65 63 61 75 73 65 20 74  l fail because t
1f80: 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 0a 77 69  he comparison.wi
1f90: 6c 6c 20 63 6f 6e 76 65 72 74 20 62 6f 74 68 20  ll convert both 
1fa0: 73 74 72 69 6e 67 73 20 69 6e 74 6f 20 66 6c 6f  strings into flo
1fb0: 61 74 69 6e 67 2d 70 6f 69 6e 74 20 6e 75 6d 62  ating-point numb
1fc0: 65 72 20 66 69 72 73 74 20 61 6e 64 20 74 68 65  er first and the
1fd0: 20 6f 6e 6c 79 0a 64 69 66 66 65 72 65 6e 63 65   only.difference
1fe0: 20 69 6e 20 74 68 65 20 73 74 72 69 6e 67 73 20   in the strings 
1ff0: 69 73 20 69 6e 20 74 68 65 20 32 30 2d 74 68 20  is in the 20-th 
2000: 64 69 67 69 74 20 77 68 69 63 68 20 65 78 63 65  digit which exce
2010: 65 64 73 20 74 68 65 20 72 65 73 6f 6c 75 74 69  eds the resoluti
2020: 6f 6e 0a 6f 66 20 61 20 36 34 2d 62 69 74 20 66  on.of a 64-bit f
2030: 6c 6f 61 74 2e 20 20 49 6e 20 63 6f 6e 74 72 61  loat.  In contra
2040: 73 74 2c 20 74 68 65 20 73 65 63 6f 6e 64 20 69  st, the second i
2050: 6e 73 65 72 74 20 6f 6e 20 74 68 65 20 72 69 67  nsert on the rig
2060: 68 74 20 77 69 6c 6c 20 77 6f 72 6b 0a 62 65 63  ht will work.bec
2070: 61 75 73 65 20 69 6e 20 74 68 61 74 20 63 61 73  ause in that cas
2080: 65 2c 20 74 68 65 20 6e 75 6d 62 65 72 73 20 62  e, the numbers b
2090: 65 69 6e 67 20 69 6e 73 65 72 74 65 64 20 61 72  eing inserted ar
20a0: 65 20 73 74 72 69 6e 67 73 20 61 6e 64 20 61 72  e strings and ar
20b0: 65 0a 63 6f 6d 70 61 72 65 64 20 75 73 69 6e 67  e.compared using
20c0: 20 6d 65 6d 63 6d 70 28 29 2e 3c 2f 70 3e 0a 0a   memcmp().</p>..
20d0: 3c 70 3e 0a 4e 75 6d 65 72 69 63 20 61 6e 64 20  <p>.Numeric and 
20e0: 74 65 78 74 20 74 79 70 65 73 20 6d 61 6b 65 20  text types make 
20f0: 61 20 64 69 66 66 65 72 65 6e 63 65 20 66 6f 72  a difference for
2100: 20 74 68 65 20 44 49 53 54 49 4e 43 54 20 6b 65   the DISTINCT ke
2110: 79 77 6f 72 64 20 74 6f 6f 3a 0a 3c 2f 70 3e 0a  yword too:.</p>.
2120: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
2130: 65 3e 0a 43 52 45 41 54 45 20 54 41 42 4c 45 20  e>.CREATE TABLE 
2140: 74 33 28 61 20 49 4e 54 45 47 45 52 29 3b 20 20  t3(a INTEGER);  
2150: 20 20 20 20 20 20 20 20 20 20 20 20 20 43 52 45               CRE
2160: 41 54 45 20 54 41 42 4c 45 20 74 34 28 62 20 54  ATE TABLE t4(b T
2170: 45 58 54 29 3b 0a 49 4e 53 45 52 54 20 49 4e 54  EXT);.INSERT INT
2180: 4f 20 74 33 20 56 41 4c 55 45 53 28 27 30 27 29  O t3 VALUES('0')
2190: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
21a0: 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 34 20 56  INSERT INTO t4 V
21b0: 41 4c 55 45 53 28 30 29 3b 0a 49 4e 53 45 52 54  ALUES(0);.INSERT
21c0: 20 49 4e 54 4f 20 74 33 20 56 41 4c 55 45 53 28   INTO t3 VALUES(
21d0: 27 30 2e 30 27 29 3b 20 20 20 20 20 20 20 20 20  '0.0');         
21e0: 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20      INSERT INTO 
21f0: 74 34 20 56 41 4c 55 45 53 28 30 2e 30 29 3b 0a  t4 VALUES(0.0);.
2200: 53 45 4c 45 43 54 20 44 49 53 54 49 4e 43 54 20  SELECT DISTINCT 
2210: 2a 20 46 52 4f 4d 20 74 33 3b 20 20 20 20 20 20  * FROM t3;      
2220: 20 20 20 20 20 20 20 20 20 20 53 45 4c 45 43 54            SELECT
2230: 20 44 49 53 54 49 4e 43 54 20 2a 20 46 52 4f 4d   DISTINCT * FROM
2240: 20 74 34 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f   t4;.</pre></blo
2250: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68  ckquote>..<p>.Th
2260: 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  e SELECT stateme
2270: 6e 74 20 6f 6e 20 74 68 65 20 6c 65 66 74 20 72  nt on the left r
2280: 65 74 75 72 6e 73 20 61 20 73 69 6e 67 6c 65 20  eturns a single 
2290: 72 6f 77 20 73 69 6e 63 65 20 27 30 27 20 61 6e  row since '0' an
22a0: 64 20 27 30 2e 30 27 0a 61 72 65 20 74 72 65 61  d '0.0'.are trea
22b0: 74 65 64 20 61 73 20 6e 75 6d 62 65 72 73 20 61  ted as numbers a
22c0: 6e 64 20 61 72 65 20 74 68 65 72 65 66 6f 72 65  nd are therefore
22d0: 20 69 6e 64 69 73 74 69 6e 63 74 2e 20 20 42 75   indistinct.  Bu
22e0: 74 20 74 68 65 20 53 45 4c 45 43 54 20 0a 73 74  t the SELECT .st
22f0: 61 74 65 6d 65 6e 74 20 6f 6e 20 74 68 65 20 72  atement on the r
2300: 69 67 68 74 20 72 65 74 75 72 6e 73 20 74 77 6f  ight returns two
2310: 20 72 6f 77 73 20 73 69 6e 63 65 20 30 20 61 6e   rows since 0 an
2320: 64 20 30 2e 30 20 61 72 65 20 74 72 65 61 74 65  d 0.0 are treate
2330: 64 0a 61 20 73 74 72 69 6e 67 73 20 77 68 69 63  d.a strings whic
2340: 68 20 61 72 65 20 64 69 66 66 65 72 65 6e 74 2e  h are different.
2350: 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  </p>.}..puts {.<
2360: 70 3e 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e  p><hr /></p>.<p>
2370: 3c 61 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68  <a href="index.h
2380: 74 6d 6c 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f  tml"><img src="/
2390: 67 6f 62 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64  goback.jpg" bord
23a0: 65 72 3d 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20  er=0 />.Back to 
23b0: 74 68 65 20 53 51 4c 69 74 65 20 48 6f 6d 65 20  the SQLite Home 
23c0: 50 61 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c  Page</a>.</p>..<
23d0: 2f 62 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a     /body></html>}.