/ Hex Artifact Content
Login

Artifact 33a74d727615ccbee8be7c8efd5876ce008c4b0e:


0000: 23 0a 23 20 52 75 6e 20 74 68 69 73 20 54 63 6c  #.# Run this Tcl
0010: 20 73 63 72 69 70 74 20 74 6f 20 67 65 6e 65 72   script to gener
0020: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 2e 68  ate the sqlite.h
0030: 74 6d 6c 20 66 69 6c 65 2e 0a 23 0a 73 65 74 20  tml file..#.set 
0040: 72 63 73 69 64 20 7b 24 49 64 3a 20 6c 61 6e 67  rcsid {$Id: lang
0050: 2e 74 63 6c 2c 76 20 31 2e 31 30 20 32 30 30 31  .tcl,v 1.10 2001
0060: 2f 30 39 2f 32 38 20 31 37 3a 34 37 3a 31 34 20  /09/28 17:47:14 
0070: 64 72 68 20 45 78 70 20 24 7d 0a 0a 70 75 74 73  drh Exp $}..puts
0080: 20 7b 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64 3e 0a   {<html>.<head>.
0090: 20 20 3c 74 69 74 6c 65 3e 51 75 65 72 79 20 4c    <title>Query L
00a0: 61 6e 67 75 61 67 65 20 55 6e 64 65 72 73 74 6f  anguage Understo
00b0: 6f 64 20 42 79 20 53 51 4c 69 74 65 3c 2f 74 69  od By SQLite</ti
00c0: 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f  tle>.</head>.<bo
00d0: 64 79 20 62 67 63 6f 6c 6f 72 3d 77 68 69 74 65  dy bgcolor=white
00e0: 3e 0a 3c 68 31 20 61 6c 69 67 6e 3d 63 65 6e 74  >.<h1 align=cent
00f0: 65 72 3e 0a 53 51 4c 20 41 73 20 55 6e 64 65 72  er>.SQL As Under
0100: 73 74 6f 6f 64 20 42 79 20 53 51 4c 69 74 65 0a  stood By SQLite.
0110: 3c 2f 68 31 3e 7d 0a 70 75 74 73 20 22 3c 70 20  </h1>}.puts "<p 
0120: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 0a 28 54  align=center>.(T
0130: 68 69 73 20 70 61 67 65 20 77 61 73 20 6c 61 73  his page was las
0140: 74 20 6d 6f 64 69 66 69 65 64 20 6f 6e 20 5b 6c  t modified on [l
0150: 72 61 6e 67 65 20 24 72 63 73 69 64 20 33 20 34  range $rcsid 3 4
0160: 5d 20 47 4d 54 29 0a 3c 2f 70 3e 22 0a 0a 70 75  ] GMT).</p>"..pu
0170: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 53 51 4c 69  ts {.<p>The SQLi
0180: 74 65 20 6c 69 62 72 61 72 79 20 75 6e 64 65 72  te library under
0190: 73 74 61 6e 64 73 20 6d 6f 73 74 20 6f 66 20 74  stands most of t
01a0: 68 65 20 73 74 61 6e 64 61 72 64 20 53 51 4c 0a  he standard SQL.
01b0: 6c 61 6e 67 75 61 67 65 2e 20 20 42 75 74 20 69  language.  But i
01c0: 74 20 64 6f 65 73 20 6f 6d 69 74 20 73 6f 6d 65  t does omit some
01d0: 20 66 65 61 74 75 72 65 73 20 77 68 69 6c 65 20   features while 
01e0: 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65  at the same time
01f0: 0a 61 64 64 69 6e 67 20 61 20 66 65 77 20 66 65  .adding a few fe
0200: 61 74 75 72 65 73 20 6f 66 20 69 74 73 20 6f 77  atures of its ow
0210: 6e 2e 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e  n.  This documen
0220: 74 20 61 74 74 65 6d 70 74 73 20 74 6f 0a 64 65  t attempts to.de
0230: 73 63 72 69 62 65 20 70 65 72 63 69 73 65 6c 79  scribe percisely
0240: 20 77 68 61 74 20 70 61 72 74 73 20 6f 66 20 74   what parts of t
0250: 68 65 20 53 51 4c 20 6c 61 6e 67 75 61 67 65 20  he SQL language 
0260: 53 51 4c 69 74 65 20 64 6f 65 73 0a 61 6e 64 20  SQLite does.and 
0270: 64 6f 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74  does not support
0280: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 61 6c 6c  .</p>..<p>In all
0290: 20 6f 66 20 74 68 65 20 73 79 6e 74 61 78 20 64   of the syntax d
02a0: 69 61 67 72 61 6d 73 20 74 68 61 74 20 66 6f 6c  iagrams that fol
02b0: 6c 6f 77 2c 20 6c 69 74 65 72 61 6c 20 74 65 78  low, literal tex
02c0: 74 20 69 73 20 73 68 6f 77 6e 20 69 6e 0a 62 6f  t is shown in.bo
02d0: 6c 64 20 62 6c 75 65 2e 20 20 4e 6f 6e 2d 74 65  ld blue.  Non-te
02e0: 72 6d 69 6e 61 6c 20 73 79 6d 62 6f 6c 73 20 61  rminal symbols a
02f0: 72 65 20 73 68 6f 77 6e 20 69 6e 20 69 74 61 6c  re shown in ital
0300: 69 63 20 72 65 64 2e 20 20 4f 70 65 72 61 74 6f  ic red.  Operato
0310: 72 73 0a 74 68 61 74 20 61 72 65 20 70 61 72 74  rs.that are part
0320: 20 6f 66 20 74 68 65 20 73 79 6e 74 61 63 74 69   of the syntacti
0330: 63 20 6d 61 72 6b 75 70 20 69 74 73 65 6c 66 20  c markup itself 
0340: 61 72 65 20 73 68 6f 77 6e 20 69 6e 20 62 6c 61  are shown in bla
0350: 63 6b 20 72 6f 6d 61 6e 2e 3c 2f 70 3e 0a 0a 3c  ck roman.</p>..<
0360: 70 3e 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20  p>This document 
0370: 69 73 20 6a 75 73 74 20 61 6e 20 6f 76 65 72 76  is just an overv
0380: 69 65 77 20 6f 66 20 74 68 65 20 53 51 4c 20 73  iew of the SQL s
0390: 79 6e 74 61 78 20 69 6d 70 6c 65 6d 65 6e 74 65  yntax implemente
03a0: 64 0a 62 79 20 53 51 4c 69 74 65 2e 20 20 4d 61  d.by SQLite.  Ma
03b0: 6e 79 20 6c 6f 77 2d 6c 65 76 65 6c 20 70 72 6f  ny low-level pro
03c0: 64 75 63 74 69 6f 6e 73 20 61 72 65 20 6f 6d 69  ductions are omi
03d0: 74 74 65 64 2e 20 20 46 6f 72 20 64 65 74 61 69  tted.  For detai
03e0: 6c 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a  led information.
03f0: 6f 6e 20 74 68 65 20 6c 61 6e 67 75 61 67 65 20  on the language 
0400: 74 68 61 74 20 53 51 4c 69 74 65 20 75 6e 64 65  that SQLite unde
0410: 72 73 74 61 6e 64 73 2c 20 72 65 66 65 72 20 74  rstands, refer t
0420: 6f 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64  o the source cod
0430: 65 2e 3c 2f 70 3e 0a 0a 0a 3c 70 3e 53 51 4c 69  e.</p>...<p>SQLi
0440: 74 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68  te implements th
0450: 65 20 66 6f 6c 6c 6f 77 20 53 51 4c 20 63 6f 6d  e follow SQL com
0460: 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 3c 70 3e 3c 75  mands:</p>.<p><u
0470: 6c 3e 0a 7d 0a 0a 66 6f 72 65 61 63 68 20 7b 73  l>.}..foreach {s
0480: 65 63 74 69 6f 6e 7d 20 5b 6c 73 6f 72 74 20 2d  ection} [lsort -
0490: 69 6e 64 65 78 20 30 20 2d 64 69 63 74 69 6f 6e  index 0 -diction
04a0: 61 72 79 20 7b 0a 20 20 7b 7b 43 52 45 41 54 45  ary {.  {{CREATE
04b0: 20 54 41 42 4c 45 7d 20 63 72 65 61 74 65 74 61   TABLE} createta
04c0: 62 6c 65 7d 0a 20 20 7b 7b 43 52 45 41 54 45 20  ble}.  {{CREATE 
04d0: 49 4e 44 45 58 7d 20 63 72 65 61 74 65 69 6e 64  INDEX} createind
04e0: 65 78 7d 0a 20 20 7b 56 41 43 55 55 4d 20 76 61  ex}.  {VACUUM va
04f0: 63 75 75 6d 7d 0a 20 20 7b 7b 44 52 4f 50 20 54  cuum}.  {{DROP T
0500: 41 42 4c 45 7d 20 64 72 6f 70 74 61 62 6c 65 7d  ABLE} droptable}
0510: 0a 20 20 7b 7b 44 52 4f 50 20 49 4e 44 45 58 7d  .  {{DROP INDEX}
0520: 20 64 72 6f 70 69 6e 64 65 78 7d 0a 20 20 7b 49   dropindex}.  {I
0530: 4e 53 45 52 54 20 69 6e 73 65 72 74 7d 0a 20 20  NSERT insert}.  
0540: 7b 44 45 4c 45 54 45 20 64 65 6c 65 74 65 7d 0a  {DELETE delete}.
0550: 20 20 7b 55 50 44 41 54 45 20 75 70 64 61 74 65    {UPDATE update
0560: 7d 0a 20 20 7b 53 45 4c 45 43 54 20 73 65 6c 65  }.  {SELECT sele
0570: 63 74 7d 0a 20 20 7b 43 4f 50 59 20 63 6f 70 79  ct}.  {COPY copy
0580: 7d 0a 20 20 7b 45 58 50 4c 41 49 4e 20 65 78 70  }.  {EXPLAIN exp
0590: 6c 61 69 6e 7d 0a 20 20 7b 65 78 70 72 65 73 73  lain}.  {express
05a0: 69 6f 6e 20 65 78 70 72 7d 0a 20 20 7b 7b 42 45  ion expr}.  {{BE
05b0: 47 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 7d  GIN TRANSACTION}
05c0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 7d 0a 20 20   transaction}.  
05d0: 7b 50 52 41 47 4d 41 20 70 72 61 67 6d 61 7d 0a  {PRAGMA pragma}.
05e0: 7d 5d 20 7b 0a 20 20 70 75 74 73 20 22 3c 6c 69  }] {.  puts "<li
05f0: 3e 3c 61 20 68 72 65 66 3d 5c 22 23 5b 6c 69 6e  ><a href=\"#[lin
0600: 64 65 78 20 24 73 65 63 74 69 6f 6e 20 31 5d 5c  dex $section 1]\
0610: 22 3e 5b 6c 69 6e 64 65 78 20 24 73 65 63 74 69  ">[lindex $secti
0620: 6f 6e 20 30 5d 3c 2f 61 3e 3c 2f 6c 69 3e 22 0a  on 0]</a></li>".
0630: 7d 0a 70 75 74 73 20 7b 3c 2f 75 6c 3e 3c 2f 70  }.puts {</ul></p
0640: 3e 0a 0a 3c 70 3e 44 65 74 61 69 6c 73 20 6f 6e  >..<p>Details on
0650: 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   the implementat
0660: 69 6f 6e 20 6f 66 20 65 61 63 68 20 63 6f 6d 6d  ion of each comm
0670: 61 6e 64 20 61 72 65 20 70 72 6f 76 69 64 65 64  and are provided
0680: 20 69 6e 0a 74 68 65 20 73 65 71 75 65 6c 2e 3c   in.the sequel.<
0690: 2f 70 3e 0a 7d 0a 0a 70 72 6f 63 20 53 79 6e 74  /p>.}..proc Synt
06a0: 61 78 20 7b 61 72 67 73 7d 20 7b 0a 20 20 70 75  ax {args} {.  pu
06b0: 74 73 20 7b 3c 74 61 62 6c 65 20 63 65 6c 6c 70  ts {<table cellp
06c0: 61 64 64 69 6e 67 3d 22 31 35 22 3e 7d 0a 20 20  adding="15">}.  
06d0: 66 6f 72 65 61 63 68 20 7b 72 75 6c 65 20 62 6f  foreach {rule bo
06e0: 64 79 7d 20 24 61 72 67 73 20 7b 0a 20 20 20 20  dy} $args {.    
06f0: 70 75 74 73 20 22 3c 74 72 3e 3c 74 64 20 61 6c  puts "<tr><td al
0700: 69 67 6e 3d 5c 22 72 69 67 68 74 5c 22 20 76 61  ign=\"right\" va
0710: 6c 69 67 6e 3d 5c 22 74 6f 70 5c 22 3e 22 0a 20  lign=\"top\">". 
0720: 20 20 20 70 75 74 73 20 22 3c 69 3e 3c 66 6f 6e     puts "<i><fon
0730: 74 20 63 6f 6c 6f 72 3d 5c 22 23 66 66 33 34 33  t color=\"#ff343
0740: 34 5c 22 3e 24 72 75 6c 65 3c 2f 66 6f 6e 74 3e  4\">$rule</font>
0750: 3c 2f 69 3e 26 6e 62 73 70 3b 3a 3a 3d 3c 2f 74  </i>&nbsp;::=</t
0760: 64 3e 22 0a 20 20 20 20 72 65 67 73 75 62 20 2d  d>".    regsub -
0770: 61 6c 6c 20 3c 20 24 62 6f 64 79 20 7b 25 4c 54  all < $body {%LT
0780: 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75  } body.    regsu
0790: 62 20 2d 61 6c 6c 20 3e 20 24 62 6f 64 79 20 7b  b -all > $body {
07a0: 25 47 54 7d 20 62 6f 64 79 0a 20 20 20 20 72 65  %GT} body.    re
07b0: 67 73 75 62 20 2d 61 6c 6c 20 25 4c 54 20 24 62  gsub -all %LT $b
07c0: 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f 62 3e  ody {</font></b>
07d0: 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22  <i><font color="
07e0: 23 66 66 33 34 33 34 22 3e 7d 20 62 6f 64 79 0a  #ff3434">} body.
07f0: 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20      regsub -all 
0800: 25 47 54 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e  %GT $body {</fon
0810: 74 3e 3c 2f 69 3e 3c 62 3e 3c 66 6f 6e 74 20 63  t></i><b><font c
0820: 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e 7d  olor="#2c2cf0">}
0830: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
0840: 20 2d 61 6c 6c 20 7b 5b 5d 7c 5b 2a 3f 5d 7d 20   -all {[]|[*?]} 
0850: 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f  $body {</font></
0860: 62 3e 26 3c 62 3e 3c 66 6f 6e 74 20 63 6f 6c 6f  b>&<b><font colo
0870: 72 3d 22 23 32 63 32 63 66 30 22 3e 7d 20 62 6f  r="#2c2cf0">} bo
0880: 64 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61  dy.    regsub -a
0890: 6c 6c 20 22 5c 6e 22 20 5b 73 74 72 69 6e 67 20  ll "\n" [string 
08a0: 74 72 69 6d 20 24 62 6f 64 79 5d 20 22 3c 62 72  trim $body] "<br
08b0: 3e 5c 6e 22 20 62 6f 64 79 0a 20 20 20 20 72 65  >\n" body.    re
08c0: 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 20 20 2a  gsub -all "\n  *
08d0: 22 20 24 62 6f 64 79 20 22 5c 6e 5c 5c 26 6e 62  " $body "\n\\&nb
08e0: 73 70 3b 5c 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62  sp;\\&nbsp;\\&nb
08f0: 73 70 3b 5c 5c 26 6e 62 73 70 3b 22 20 62 6f 64  sp;\\&nbsp;" bod
0900: 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c  y.    regsub -al
0910: 6c 20 7b 5b 7c 2c 2e 2a 28 29 5d 7d 20 24 62 6f  l {[|,.*()]} $bo
0920: 64 79 20 7b 3c 62 69 67 3e 26 3c 2f 62 69 67 3e  dy {<big>&</big>
0930: 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75  } body.    regsu
0940: 62 20 2d 61 6c 6c 20 7b 20 3d 20 7d 20 24 62 6f  b -all { = } $bo
0950: 64 79 20 7b 20 3c 62 69 67 3e 3d 3c 2f 62 69 67  dy { <big>=</big
0960: 3e 20 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67  > } body.    reg
0970: 73 75 62 20 2d 61 6c 6c 20 7b 53 54 41 52 7d 20  sub -all {STAR} 
0980: 24 62 6f 64 79 20 7b 3c 62 69 67 3e 2a 3c 2f 62  $body {<big>*</b
0990: 69 67 3e 7d 20 62 6f 64 79 0a 20 20 20 20 70 75  ig>} body.    pu
09a0: 74 73 20 22 3c 74 64 3e 3c 62 3e 3c 66 6f 6e 74  ts "<td><b><font
09b0: 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32 63 66 30   color=\"#2c2cf0
09c0: 5c 22 3e 24 62 6f 64 79 3c 2f 66 6f 6e 74 3e 3c  \">$body</font><
09d0: 2f 62 3e 3c 2f 74 64 3e 3c 2f 74 72 3e 22 0a 20  /b></td></tr>". 
09e0: 20 7d 0a 20 20 70 75 74 73 20 7b 3c 2f 74 61 62   }.  puts {</tab
09f0: 6c 65 3e 7d 0a 7d 0a 70 72 6f 63 20 4f 70 65 72  le>}.}.proc Oper
0a00: 61 74 6f 72 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20  ator {name} {.  
0a10: 72 65 74 75 72 6e 20 22 3c 66 6f 6e 74 20 63 6f  return "<font co
0a20: 6c 6f 72 3d 5c 22 23 32 63 32 63 66 30 5c 22 3e  lor=\"#2c2cf0\">
0a30: 3c 62 69 67 3e 24 6e 61 6d 65 3c 2f 62 69 67 3e  <big>$name</big>
0a40: 3c 2f 66 6f 6e 74 3e 22 0a 7d 0a 70 72 6f 63 20  </font>".}.proc 
0a50: 4e 6f 6e 74 65 72 6d 69 6e 61 6c 20 7b 6e 61 6d  Nonterminal {nam
0a60: 65 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 22 3c  e} {.  return "<
0a70: 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22  i><font color=\"
0a80: 23 66 66 33 34 33 34 5c 22 3e 24 6e 61 6d 65 3c  #ff3434\">$name<
0a90: 2f 66 6f 6e 74 3e 3c 2f 69 3e 22 0a 7d 0a 70 72  /font></i>".}.pr
0aa0: 6f 63 20 4b 65 79 77 6f 72 64 20 7b 6e 61 6d 65  oc Keyword {name
0ab0: 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 22 3c 66  } {.  return "<f
0ac0: 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32  ont color=\"#2c2
0ad0: 63 66 30 5c 22 3e 24 6e 61 6d 65 3c 2f 66 6f 6e  cf0\">$name</fon
0ae0: 74 3e 22 0a 7d 0a 20 0a 0a 70 72 6f 63 20 53 65  t>".}. ..proc Se
0af0: 63 74 69 6f 6e 20 7b 6e 61 6d 65 20 7b 6c 61 62  ction {name {lab
0b00: 65 6c 20 7b 7d 7d 7d 20 7b 0a 20 20 70 75 74 73  el {}}} {.  puts
0b10: 20 22 5c 6e 3c 68 72 20 2f 3e 22 0a 20 20 69 66   "\n<hr />".  if
0b20: 20 7b 24 6c 61 62 65 6c 21 3d 22 22 7d 20 7b 0a   {$label!=""} {.
0b30: 20 20 20 20 70 75 74 73 20 22 3c 61 20 6e 61 6d      puts "<a nam
0b40: 65 3d 5c 22 24 6c 61 62 65 6c 5c 22 3e 22 0a 20  e=\"$label\">". 
0b50: 20 7d 0a 20 20 70 75 74 73 20 22 3c 68 31 3e 24   }.  puts "<h1>$
0b60: 6e 61 6d 65 3c 2f 68 31 3e 5c 6e 22 0a 7d 0a 0a  name</h1>\n".}..
0b70: 70 72 6f 63 20 45 78 61 6d 70 6c 65 20 7b 74 65  proc Example {te
0b80: 78 74 7d 20 7b 0a 20 20 70 75 74 73 20 22 3c 62  xt} {.  puts "<b
0b90: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 24  lockquote><pre>$
0ba0: 74 65 78 74 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63  text</pre></bloc
0bb0: 6b 71 75 6f 74 65 3e 22 0a 7d 0a 0a 53 65 63 74  kquote>".}..Sect
0bc0: 69 6f 6e 20 7b 42 45 47 49 4e 20 54 52 41 4e 53  ion {BEGIN TRANS
0bd0: 41 43 54 49 4f 4e 7d 20 63 72 65 61 74 65 69 6e  ACTION} createin
0be0: 64 65 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  dex..Syntax {sql
0bf0: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 42 45  -statement} {.BE
0c00: 47 49 4e 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e  GIN [TRANSACTION
0c10: 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 53 79 6e   [<name>]].}.Syn
0c20: 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65  tax {sql-stateme
0c30: 6e 74 7d 20 7b 0a 45 4e 44 20 5b 54 52 41 4e 53  nt} {.END [TRANS
0c40: 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d  ACTION [<name>]]
0c50: 0a 7d 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  .}.Syntax {sql-s
0c60: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 4f 4d 4d  tatement} {.COMM
0c70: 49 54 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e 20  IT [TRANSACTION 
0c80: 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 53 79 6e 74  [<name>]].}.Synt
0c90: 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e  ax {sql-statemen
0ca0: 74 7d 20 7b 0a 52 4f 4c 4c 42 41 43 4b 20 5b 54  t} {.ROLLBACK [T
0cb0: 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d  RANSACTION [<nam
0cc0: 65 3e 5d 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  e>]].}..puts {.<
0cd0: 70 3e 42 65 67 69 6e 6e 69 6e 67 20 69 6e 20 76  p>Beginning in v
0ce0: 65 72 73 69 6f 6e 20 32 2e 30 2c 20 53 51 4c 69  ersion 2.0, SQLi
0cf0: 74 65 20 73 75 70 70 6f 72 74 73 20 74 72 61 6e  te supports tran
0d00: 73 61 63 74 69 6f 6e 73 20 77 69 74 68 0a 72 6f  sactions with.ro
0d10: 6c 6c 62 61 63 6b 20 61 6e 64 20 61 74 6f 6d 69  llback and atomi
0d20: 63 20 63 6f 6d 6d 69 74 2e 20 20 48 6f 77 65 76  c commit.  Howev
0d30: 65 72 2c 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c  er, only a singl
0d40: 65 20 6c 65 76 65 6c 20 6f 66 0a 74 72 61 6e 73  e level of.trans
0d50: 61 63 74 69 6f 6e 20 69 73 20 61 6c 6c 6f 77 65  action is allowe
0d60: 64 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72  d.  In other wor
0d70: 64 73 2c 20 74 72 61 6e 73 61 63 74 69 6f 6e 73  ds, transactions
0d80: 0a 6d 61 79 20 6e 6f 74 20 62 65 20 6e 65 73 74  .may not be nest
0d90: 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4e 6f  ed..</p>..<p>.No
0da0: 20 63 68 61 6e 67 65 73 20 63 61 6e 20 62 65 20   changes can be 
0db0: 6d 61 64 65 20 74 6f 20 74 68 65 20 64 61 74 61  made to the data
0dc0: 62 61 73 65 20 65 78 63 65 70 74 20 77 69 74 68  base except with
0dd0: 69 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e  in a transaction
0de0: 2e 0a 41 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68  ..Any command th
0df0: 61 74 20 63 68 61 6e 67 65 73 20 74 68 65 20 64  at changes the d
0e00: 61 74 61 62 61 73 65 20 28 62 61 73 69 63 61 6c  atabase (basical
0e10: 6c 79 2c 20 61 6e 79 20 53 51 4c 20 63 6f 6d 6d  ly, any SQL comm
0e20: 61 6e 64 0a 6f 74 68 65 72 20 74 68 61 6e 20 53  and.other than S
0e30: 45 4c 45 43 54 29 20 77 69 6c 6c 20 61 75 74 6f  ELECT) will auto
0e40: 6d 61 74 69 63 61 6c 6c 79 20 73 74 61 72 74 73  matically starts
0e50: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
0e60: 66 0a 77 68 65 6e 20 69 73 20 6e 6f 74 20 61 6c  f.when is not al
0e70: 72 65 61 64 79 20 69 6e 20 65 66 66 65 63 74 2e  ready in effect.
0e80: 20 20 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20    Automatically 
0e90: 73 74 61 72 65 64 20 74 72 61 6e 73 61 63 74 69  stared transacti
0ea0: 6f 6e 73 0a 61 72 65 20 63 6f 6d 6d 69 74 74 65  ons.are committe
0eb0: 64 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73  d at the conclus
0ec0: 69 6f 6e 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61  ion of the comma
0ed0: 6e 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 72  nd..</p>..<p>.Tr
0ee0: 61 6e 73 61 63 74 69 6f 6e 73 20 63 61 6e 20 62  ansactions can b
0ef0: 65 20 73 74 61 72 74 65 64 20 6d 61 6e 75 61 6c  e started manual
0f00: 6c 79 20 75 73 69 6e 67 20 74 68 65 20 42 45 47  ly using the BEG
0f10: 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 0a 63  IN TRANSACTION.c
0f20: 6f 6d 6d 61 6e 64 2e 20 53 75 63 68 20 74 72 61  ommand. Such tra
0f30: 6e 73 61 63 74 69 6f 6e 73 20 70 65 72 73 69 73  nsactions persis
0f40: 74 20 75 6e 74 69 6c 20 61 20 43 4f 4d 4d 49 54  t until a COMMIT
0f50: 20 6f 72 20 52 4f 4c 4c 42 41 43 4b 0a 6f 72 20   or ROLLBACK.or 
0f60: 75 6e 74 69 6c 20 61 6e 20 65 72 72 6f 72 20 6f  until an error o
0f70: 63 63 75 72 73 20 6f 72 20 74 68 65 20 64 61 74  ccurs or the dat
0f80: 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 2e  abase is closed.
0f90: 20 20 49 66 20 61 6e 0a 65 72 72 6f 72 20 69 73    If an.error is
0fa0: 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 6f 72 20   encountered or 
0fb0: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
0fc0: 63 6c 6f 73 65 64 2c 20 74 68 65 20 74 72 61 6e  closed, the tran
0fd0: 73 61 63 74 69 6f 6e 0a 69 73 20 61 75 74 6f 6d  saction.is autom
0fe0: 61 74 69 63 61 6c 6c 79 20 72 6f 6c 6c 65 64 20  atically rolled 
0ff0: 62 61 63 6b 2e 20 20 54 68 65 20 45 4e 44 20 54  back.  The END T
1000: 52 41 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d 61  RANSACTION comma
1010: 6e 64 20 69 73 0a 61 20 61 6c 69 61 73 20 66 6f  nd is.a alias fo
1020: 72 20 43 4f 4d 4d 49 54 2e 0a 3c 2f 70 3e 0a 7d  r COMMIT..</p>.}
1030: 0a 0a 53 65 63 74 69 6f 6e 20 43 4f 50 59 20 63  ..Section COPY c
1040: 6f 70 79 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  opy..Syntax {sql
1050: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 4f  -statement} {.CO
1060: 50 59 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  PY <table-name> 
1070: 46 52 4f 4d 20 3c 66 69 6c 65 6e 61 6d 65 3e 0a  FROM <filename>.
1080: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
1090: 20 43 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73   COPY command is
10a0: 20 61 6e 20 65 78 74 65 6e 73 69 6f 6e 20 75 73   an extension us
10b0: 65 64 20 74 6f 20 6c 6f 61 64 20 6c 61 72 67 65  ed to load large
10c0: 20 61 6d 6f 75 6e 74 73 20 6f 66 0a 64 61 74 61   amounts of.data
10d0: 20 69 6e 74 6f 20 61 20 74 61 62 6c 65 2e 20 20   into a table.  
10e0: 49 74 20 69 73 20 6d 6f 64 65 6c 65 64 20 61 66  It is modeled af
10f0: 74 65 72 20 61 20 73 69 6d 69 6c 61 72 20 63 6f  ter a similar co
1100: 6d 6d 61 6e 64 20 66 6f 75 6e 64 0a 69 6e 20 50  mmand found.in P
1110: 6f 73 74 67 72 65 53 51 4c 2e 20 20 49 6e 20 66  ostgreSQL.  In f
1120: 61 63 74 2c 20 74 68 65 20 53 51 4c 69 74 65 20  act, the SQLite 
1130: 43 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73 20  COPY command is 
1140: 73 70 65 63 69 66 69 63 61 6c 6c 79 0a 64 65 73  specifically.des
1150: 69 67 6e 65 64 20 74 6f 20 62 65 20 61 62 6c 65  igned to be able
1160: 20 74 6f 20 72 65 61 64 20 74 68 65 20 6f 75 74   to read the out
1170: 70 75 74 20 6f 66 20 74 68 65 20 50 6f 73 74 67  put of the Postg
1180: 72 65 53 51 4c 20 64 75 6d 70 0a 75 74 69 6c 69  reSQL dump.utili
1190: 74 79 20 3c 62 3e 70 67 5f 64 75 6d 70 3c 2f 62  ty <b>pg_dump</b
11a0: 3e 20 73 6f 20 74 68 61 74 20 64 61 74 61 20 63  > so that data c
11b0: 61 6e 20 62 65 20 65 61 73 69 6c 79 20 74 72 61  an be easily tra
11c0: 6e 73 66 65 72 72 65 64 20 66 72 6f 6d 0a 50 6f  nsferred from.Po
11d0: 73 74 67 72 65 53 51 4c 20 69 6e 74 6f 20 53 51  stgreSQL into SQ
11e0: 4c 69 74 65 2e 3c 70 3e 0a 0a 3c 70 3e 54 68 65  Lite.<p>..<p>The
11f0: 20 74 61 62 6c 65 2d 6e 61 6d 65 20 69 73 20 74   table-name is t
1200: 68 65 20 6e 61 6d 65 20 6f 66 20 61 6e 20 65 78  he name of an ex
1210: 69 73 74 69 6e 67 20 74 61 62 6c 65 20 77 68 69  isting table whi
1220: 63 68 20 69 73 20 74 6f 0a 62 65 20 66 69 6c 6c  ch is to.be fill
1230: 65 64 20 77 69 74 68 20 64 61 74 61 2e 20 20 54  ed with data.  T
1240: 68 65 20 66 69 6c 65 6e 61 6d 65 20 69 73 20 61  he filename is a
1250: 20 73 74 72 69 6e 67 20 6f 72 20 69 64 65 6e 74   string or ident
1260: 69 66 69 65 72 20 74 68 61 74 0a 6e 61 6d 65 73  ifier that.names
1270: 20 61 20 66 69 6c 65 20 66 72 6f 6d 20 77 68 69   a file from whi
1280: 63 68 20 64 61 74 61 20 77 69 6c 6c 20 62 65 20  ch data will be 
1290: 72 65 61 64 2e 20 20 54 68 65 20 66 69 6c 65 6e  read.  The filen
12a0: 61 6d 65 20 63 61 6e 20 62 65 0a 74 68 65 20 3c  ame can be.the <
12b0: 62 3e 53 54 44 49 4e 3c 2f 62 3e 20 74 6f 20 72  b>STDIN</b> to r
12c0: 65 61 64 20 64 61 74 61 20 66 72 6f 6d 20 73 74  ead data from st
12d0: 61 6e 64 61 72 64 20 69 6e 70 75 74 2e 3c 70 3e  andard input.<p>
12e0: 0a 0a 3c 70 3e 45 61 63 68 20 6c 69 6e 65 20 6f  ..<p>Each line o
12f0: 66 20 74 68 65 20 69 6e 70 75 74 20 66 69 6c 65  f the input file
1300: 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 69 6e   is converted in
1310: 74 6f 20 61 20 73 69 6e 67 6c 65 20 72 65 63 6f  to a single reco
1320: 72 64 0a 69 6e 20 74 68 65 20 74 61 62 6c 65 2e  rd.in the table.
1330: 20 20 43 6f 6c 75 6d 6e 73 20 61 72 65 20 73 65    Columns are se
1340: 70 61 72 61 74 65 64 20 62 79 20 74 61 62 73 2e  parated by tabs.
1350: 20 20 49 66 20 61 20 74 61 62 20 6f 63 63 75 72    If a tab occur
1360: 73 20 61 73 0a 64 61 74 61 20 77 69 74 68 69 6e  s as.data within
1370: 20 61 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20   a column, then 
1380: 74 68 61 74 20 74 61 62 20 69 73 20 70 72 65 63  that tab is prec
1390: 65 64 65 64 20 62 79 20 61 20 62 61 73 6b 73 6c  eded by a basksl
13a0: 61 73 68 20 22 5c 22 0a 63 68 61 72 61 63 74 65  ash "\".characte
13b0: 72 2e 20 20 41 20 62 61 73 6b 73 6c 61 73 68 20  r.  A baskslash 
13c0: 69 6e 20 74 68 65 20 64 61 74 61 20 61 70 70 65  in the data appe
13d0: 61 72 73 20 61 73 20 74 77 6f 20 62 61 63 6b 73  ars as two backs
13e0: 6c 61 73 68 65 73 20 69 6e 0a 61 20 72 6f 77 2e  lashes in.a row.
13f0: 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 74 68  </p>..<p>When th
1400: 65 20 69 6e 70 75 74 20 64 61 74 61 20 73 6f 75  e input data sou
1410: 72 63 65 20 69 73 20 53 54 44 49 4e 2c 20 74 68  rce is STDIN, th
1420: 65 20 69 6e 70 75 74 20 63 61 6e 20 62 65 20 74  e input can be t
1430: 65 72 6d 69 6e 61 74 65 64 0a 62 79 20 61 20 6c  erminated.by a l
1440: 69 6e 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e  ine that contain
1450: 73 20 6f 6e 6c 79 20 61 20 62 61 73 6b 73 6c 61  s only a basksla
1460: 73 68 20 61 6e 64 20 61 20 64 6f 74 3a 7d 0a 70  sh and a dot:}.p
1470: 75 74 73 20 22 5c 22 5b 4f 70 65 72 61 74 6f 72  uts "\"[Operator
1480: 20 5c 5c 2e 5d 5c 22 2e 3c 2f 70 3e 22 0a 0a 53   \\.]\".</p>"..S
1490: 65 63 74 69 6f 6e 20 7b 43 52 45 41 54 45 20 49  ection {CREATE I
14a0: 4e 44 45 58 7d 20 63 72 65 61 74 65 69 6e 64 65  NDEX} createinde
14b0: 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  x..Syntax {sql-s
14c0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41  tatement} {.CREA
14d0: 54 45 20 5b 55 4e 49 51 55 45 5d 20 49 4e 44 45  TE [UNIQUE] INDE
14e0: 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 20 0a  X <index-name> .
14f0: 4f 4e 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  ON <table-name> 
1500: 28 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20  ( <column-name> 
1510: 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e  [, <column-name>
1520: 5d 2a 20 29 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 6e  ]* ).} {column-n
1530: 61 6d 65 7d 20 7b 0a 3c 6e 61 6d 65 3e 20 5b 20  ame} {.<name> [ 
1540: 41 53 43 20 7c 20 44 45 53 43 20 5d 0a 7d 0a 0a  ASC | DESC ].}..
1550: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 43 52  puts {.<p>The CR
1560: 45 41 54 45 20 49 4e 44 45 58 20 63 6f 6d 6d 61  EATE INDEX comma
1570: 6e 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  nd consists of t
1580: 68 65 20 6b 65 79 77 6f 72 64 73 20 22 43 52 45  he keywords "CRE
1590: 41 54 45 20 49 4e 44 45 58 22 20 66 6f 6c 6c 6f  ATE INDEX" follo
15a0: 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20  wed.by the name 
15b0: 6f 66 20 74 68 65 20 6e 65 77 20 69 6e 64 65 78  of the new index
15c0: 2c 20 74 68 65 20 6b 65 79 77 6f 72 64 20 22 4f  , the keyword "O
15d0: 4e 22 2c 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  N", the name of 
15e0: 61 20 70 72 65 76 69 6f 75 73 6c 79 0a 63 72 65  a previously.cre
15f0: 61 74 65 64 20 74 61 62 6c 65 20 74 68 61 74 20  ated table that 
1600: 69 73 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64  is to be indexed
1610: 2c 20 61 6e 64 20 61 20 70 61 72 65 6e 74 68 65  , and a parenthe
1620: 73 69 7a 65 64 20 6c 69 73 74 20 6f 66 20 6e 61  sized list of na
1630: 6d 65 73 20 6f 66 0a 63 6f 6c 75 6d 6e 73 20 69  mes of.columns i
1640: 6e 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74  n the table that
1650: 20 61 72 65 20 75 73 65 64 20 66 6f 72 20 74 68   are used for th
1660: 65 20 69 6e 64 65 78 20 6b 65 79 2e 0a 45 61 63  e index key..Eac
1670: 68 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61  h column name ca
1680: 6e 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79  n be followed by
1690: 20 6f 6e 65 20 6f 66 20 74 68 65 20 22 41 53 43   one of the "ASC
16a0: 22 20 6f 72 20 22 44 45 53 43 22 20 6b 65 79 77  " or "DESC" keyw
16b0: 6f 72 64 73 0a 74 6f 20 69 6e 64 69 63 61 74 65  ords.to indicate
16c0: 20 73 6f 72 74 20 6f 72 64 65 72 2c 20 62 75 74   sort order, but
16d0: 20 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72 20   the sort order 
16e0: 69 73 20 69 67 6e 6f 72 65 64 20 69 6e 20 74 68  is ignored in th
16f0: 65 20 63 75 72 72 65 6e 74 0a 69 6d 70 6c 65 6d  e current.implem
1700: 65 6e 74 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c  entation.</p>..<
1710: 70 3e 54 68 65 72 65 20 61 72 65 20 6e 6f 20 61  p>There are no a
1720: 72 62 69 74 72 61 72 79 20 6c 69 6d 69 74 73 20  rbitrary limits 
1730: 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  on the number of
1740: 20 69 6e 64 69 63 65 73 20 74 68 61 74 20 63 61   indices that ca
1750: 6e 20 62 65 0a 61 74 74 61 63 68 65 64 20 74 6f  n be.attached to
1760: 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 2c   a single table,
1770: 20 6e 6f 72 20 6f 6e 20 74 68 65 20 6e 75 6d 62   nor on the numb
1780: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e  er of columns in
1790: 20 61 6e 20 69 6e 64 65 78 2e 3c 2f 70 3e 0a 0a   an index.</p>..
17a0: 3c 70 3e 49 66 20 74 68 65 20 55 4e 49 51 55 45  <p>If the UNIQUE
17b0: 20 6b 65 79 77 6f 72 64 20 61 70 70 65 61 72 73   keyword appears
17c0: 20 62 65 74 77 65 65 6e 20 43 52 45 41 54 45 20   between CREATE 
17d0: 61 6e 64 20 49 4e 44 45 58 20 74 68 65 6e 20 64  and INDEX then d
17e0: 75 70 6c 69 63 61 74 65 0a 69 6e 64 65 78 20 65  uplicate.index e
17f0: 6e 74 72 69 65 73 20 61 72 65 20 6e 6f 74 20 61  ntries are not a
1800: 6c 6c 6f 77 65 64 2e 20 20 41 6e 79 20 61 74 74  llowed.  Any att
1810: 65 6d 70 74 20 74 6f 20 69 6e 73 65 72 74 20 61  empt to insert a
1820: 20 64 75 70 6c 69 63 61 74 65 20 65 6e 74 72 79   duplicate entry
1830: 0a 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20  .will result in 
1840: 61 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 61  a rollback and a
1850: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e  n error message.
1860: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 65 78 61  </p>..<p>The exa
1870: 63 74 20 74 65 78 74 0a 6f 66 20 65 61 63 68 20  ct text.of each 
1880: 43 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61  CREATE INDEX sta
1890: 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 65 64  tement is stored
18a0: 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c 69 74   in the <b>sqlit
18b0: 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a 74 61 62  e_master</b>.tab
18c0: 6c 65 2e 20 20 45 76 65 72 79 74 69 6d 65 20 74  le.  Everytime t
18d0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6f  he database is o
18e0: 70 65 6e 65 64 2c 20 61 6c 6c 20 43 52 45 41 54  pened, all CREAT
18f0: 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e  E INDEX statemen
1900: 74 73 0a 61 72 65 20 72 65 61 64 20 66 72 6f 6d  ts.are read from
1910: 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d   the <b>sqlite_m
1920: 61 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65 20  aster</b> table 
1930: 61 6e 64 20 75 73 65 64 20 74 6f 20 72 65 67 65  and used to rege
1940: 6e 65 72 61 74 65 0a 53 51 4c 69 74 65 27 73 20  nerate.SQLite's 
1950: 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65  internal represe
1960: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 69  ntation of the i
1970: 6e 64 65 78 20 6c 61 79 6f 75 74 2e 3c 2f 70 3e  ndex layout.</p>
1980: 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 43 52  .}...Section {CR
1990: 45 41 54 45 20 54 41 42 4c 45 7d 20 7b 63 72 65  EATE TABLE} {cre
19a0: 61 74 65 74 61 62 6c 65 7d 0a 0a 53 79 6e 74 61  atetable}..Synta
19b0: 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20  x {sql-command} 
19c0: 7b 0a 43 52 45 41 54 45 20 54 41 42 4c 45 20 3c  {.CREATE TABLE <
19d0: 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28 0a 20 20  table-name> (.  
19e0: 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e 20 5b 2c 20  <column-def> [, 
19f0: 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e 5d 2a 0a 20  <column-def>]*. 
1a00: 20 5b 2c 20 3c 63 6f 6e 73 74 72 61 69 6e 74 3e   [, <constraint>
1a10: 5d 2a 0a 29 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 64  ]*.).} {column-d
1a20: 65 66 7d 20 7b 0a 3c 6e 61 6d 65 3e 20 3c 74 79  ef} {.<name> <ty
1a30: 70 65 3e 20 5b 3c 63 6f 6c 75 6d 6e 2d 63 6f 6e  pe> [<column-con
1a40: 73 74 72 61 69 6e 74 3e 5d 2a 0a 7d 20 7b 74 79  straint>]*.} {ty
1a50: 70 65 7d 20 7b 0a 3c 74 79 70 65 6e 61 6d 65 3e  pe} {.<typename>
1a60: 20 7c 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 28 20   |.<typename> ( 
1a70: 3c 6e 75 6d 62 65 72 3e 20 29 20 7c 0a 3c 74 79  <number> ) |.<ty
1a80: 70 65 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d 62 65  pename> ( <numbe
1a90: 72 3e 20 2c 20 3c 6e 75 6d 62 65 72 3e 20 29 0a  r> , <number> ).
1aa0: 7d 20 7b 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72  } {column-constr
1ab0: 61 69 6e 74 7d 20 7b 0a 4e 4f 54 20 4e 55 4c 4c  aint} {.NOT NULL
1ac0: 20 7c 0a 50 52 49 4d 41 52 59 20 4b 45 59 20 5b   |.PRIMARY KEY [
1ad0: 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20 7c 0a  <sort-order>] |.
1ae0: 55 4e 49 51 55 45 20 7c 0a 43 48 45 43 4b 20 28  UNIQUE |.CHECK (
1af0: 20 3c 65 78 70 72 3e 20 29 20 7c 0a 44 45 46 41   <expr> ) |.DEFA
1b00: 55 4c 54 20 3c 76 61 6c 75 65 3e 0a 7d 20 7b 63  ULT <value>.} {c
1b10: 6f 6e 73 74 72 61 69 6e 74 7d 20 7b 0a 50 52 49  onstraint} {.PRI
1b20: 4d 41 52 59 20 4b 45 59 20 28 20 3c 6e 61 6d 65  MARY KEY ( <name
1b30: 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d 2a 20 29 20  > [, <name>]* ) 
1b40: 7c 0a 55 4e 49 51 55 45 20 28 20 3c 6e 61 6d 65  |.UNIQUE ( <name
1b50: 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d 2a 20 29 20  > [, <name>]* ) 
1b60: 7c 0a 43 48 45 43 4b 20 28 20 3c 65 78 70 72 3e  |.CHECK ( <expr>
1b70: 20 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e   ).}..puts {.<p>
1b80: 41 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73  A CREATE TABLE s
1b90: 74 61 74 65 6d 65 6e 74 20 69 73 20 62 61 73 69  tatement is basi
1ba0: 63 61 6c 6c 79 20 74 68 65 20 6b 65 79 77 6f 72  cally the keywor
1bb0: 64 73 20 22 43 52 45 41 54 45 20 54 41 42 4c 45  ds "CREATE TABLE
1bc0: 22 0a 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68  ".followed by th
1bd0: 65 20 6e 61 6d 65 20 6f 66 20 61 20 6e 65 77 20  e name of a new 
1be0: 74 61 62 6c 65 20 61 6e 64 20 61 20 70 61 72 65  table and a pare
1bf0: 6e 74 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f  nthesized list o
1c00: 66 20 63 6f 6c 75 6d 6e 0a 64 65 66 69 6e 69 74  f column.definit
1c10: 69 6f 6e 73 20 61 6e 64 20 63 6f 6e 73 74 72 61  ions and constra
1c20: 69 6e 74 73 2e 20 20 54 68 65 20 74 61 62 6c 65  ints.  The table
1c30: 20 6e 61 6d 65 20 63 61 6e 20 62 65 20 65 69 74   name can be eit
1c40: 68 65 72 20 61 6e 20 69 64 65 6e 74 69 66 69 65  her an identifie
1c50: 72 0a 6f 72 20 61 20 73 74 72 69 6e 67 2e 20 20  r.or a string.  
1c60: 54 68 65 20 6f 6e 6c 79 20 72 65 73 65 72 76 65  The only reserve
1c70: 64 20 74 61 62 6c 65 20 6e 61 6d 65 20 69 73 20  d table name is 
1c80: 22 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65  "<b>sqlite_maste
1c90: 72 3c 2f 62 3e 22 20 77 68 69 63 68 0a 69 73 20  r</b>" which.is 
1ca0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
1cb0: 74 61 62 6c 65 20 74 68 61 74 20 72 65 63 6f 72  table that recor
1cc0: 64 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ds the database 
1cd0: 73 63 68 65 6d 61 2e 3c 2f 70 3e 0a 0a 3c 70 3e  schema.</p>..<p>
1ce0: 45 61 63 68 20 63 6f 6c 75 6d 6e 20 64 65 66 69  Each column defi
1cf0: 6e 69 74 69 6f 6e 20 69 73 20 74 68 65 20 6e 61  nition is the na
1d00: 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e  me of the column
1d10: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68 65   followed by the
1d20: 0a 64 61 74 61 74 79 70 65 20 66 6f 72 20 74 68  .datatype for th
1d30: 61 74 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20  at column, then 
1d40: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 70 74 69  one or more opti
1d50: 6f 6e 61 6c 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73  onal column cons
1d60: 74 72 61 69 6e 74 73 2e 0a 54 68 65 20 64 61 74  traints..The dat
1d70: 61 74 79 70 65 20 66 6f 72 20 74 68 65 20 63 6f  atype for the co
1d80: 6c 75 6d 6e 20 69 73 20 69 67 6e 6f 72 65 64 2e  lumn is ignored.
1d90: 20 20 41 6c 6c 20 69 6e 66 6f 72 6d 61 74 69 6f    All informatio
1da0: 6e 0a 69 73 20 73 74 6f 72 65 64 20 61 73 20 6e  n.is stored as n
1db0: 75 6c 6c 2d 74 65 72 6d 69 6e 61 74 65 64 20 73  ull-terminated s
1dc0: 74 72 69 6e 67 73 2e 0a 54 68 65 20 55 4e 49 51  trings..The UNIQ
1dd0: 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 61  UE constraint ca
1de0: 75 73 65 73 20 61 6e 20 69 6e 64 65 78 20 74 6f  uses an index to
1df0: 20 62 65 20 63 72 65 61 74 65 64 20 6f 6e 20 74   be created on t
1e00: 68 65 20 73 70 65 63 69 66 69 65 64 0a 63 6f 6c  he specified.col
1e10: 75 6d 6e 73 2e 20 20 54 68 69 73 20 69 6e 64 65  umns.  This inde
1e20: 78 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 75  x must contain u
1e30: 6e 69 71 75 65 20 6b 65 79 73 2e 20 20 54 68 65  nique keys.  The
1e40: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6e   PRIMARY KEY con
1e50: 73 74 72 61 69 6e 74 0a 69 73 20 61 6e 20 61 6c  straint.is an al
1e60: 69 61 73 20 66 6f 72 20 55 4e 49 51 55 45 2e 0a  ias for UNIQUE..
1e70: 54 68 65 20 44 45 46 41 55 4c 54 20 63 6f 6e 73  The DEFAULT cons
1e80: 74 72 61 69 6e 74 0a 73 70 65 63 69 66 69 65 73  traint.specifies
1e90: 20 61 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65   a default value
1ea0: 20 74 6f 20 75 73 65 20 77 68 65 6e 20 64 6f 69   to use when doi
1eb0: 6e 67 20 61 6e 20 49 4e 53 45 52 54 2e 0a 3c 2f  ng an INSERT..</
1ec0: 70 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65  p>..<p>There are
1ed0: 20 6e 6f 20 61 72 62 69 74 72 61 72 79 20 6c 69   no arbitrary li
1ee0: 6d 69 74 73 20 6f 6e 20 74 68 65 20 6e 75 6d 62  mits on the numb
1ef0: 65 72 0a 6f 66 20 63 6f 6c 75 6d 6e 73 20 6f 72  er.of columns or
1f00: 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   on the number o
1f10: 66 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 69 6e  f constraints in
1f20: 20 61 20 74 61 62 6c 65 2e 0a 54 68 65 20 74 6f   a table..The to
1f30: 74 61 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 64 61  tal amount of da
1f40: 74 61 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 72  ta in a single r
1f50: 6f 77 20 69 73 20 6c 69 6d 69 74 65 64 20 74 6f  ow is limited to
1f60: 20 36 35 35 33 35 20 62 79 74 65 73 2e 3c 2f 70   65535 bytes.</p
1f70: 3e 0a 0a 3c 70 3e 54 68 65 20 65 78 61 63 74 20  >..<p>The exact 
1f80: 74 65 78 74 0a 6f 66 20 65 61 63 68 20 43 52 45  text.of each CRE
1f90: 41 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d  ATE TABLE statem
1fa0: 65 6e 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e  ent is stored in
1fb0: 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d   the <b>sqlite_m
1fc0: 61 73 74 65 72 3c 2f 62 3e 0a 74 61 62 6c 65 2e  aster</b>.table.
1fd0: 20 20 45 76 65 72 79 74 69 6d 65 20 74 68 65 20    Everytime the 
1fe0: 64 61 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e  database is open
1ff0: 65 64 2c 20 61 6c 6c 20 43 52 45 41 54 45 20 54  ed, all CREATE T
2000: 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 73 0a  ABLE statements.
2010: 61 72 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68  are read from th
2020: 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74  e <b>sqlite_mast
2030: 65 72 3c 2f 62 3e 20 74 61 62 6c 65 20 61 6e 64  er</b> table and
2040: 20 75 73 65 64 20 74 6f 20 72 65 67 65 6e 65 72   used to regener
2050: 61 74 65 0a 53 51 4c 69 74 65 27 73 20 69 6e 74  ate.SQLite's int
2060: 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61  ernal representa
2070: 74 69 6f 6e 20 6f 66 20 74 68 65 20 74 61 62 6c  tion of the tabl
2080: 65 20 6c 61 79 6f 75 74 2e 3c 2f 70 3e 0a 7d 0a  e layout.</p>.}.
2090: 0a 53 65 63 74 69 6f 6e 20 44 45 4c 45 54 45 20  .Section DELETE 
20a0: 64 65 6c 65 74 65 0a 0a 53 79 6e 74 61 78 20 7b  delete..Syntax {
20b0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
20c0: 0a 44 45 4c 45 54 45 20 46 52 4f 4d 20 3c 74 61  .DELETE FROM <ta
20d0: 62 6c 65 2d 6e 61 6d 65 3e 20 5b 57 48 45 52 45  ble-name> [WHERE
20e0: 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d 0a 7d   <expression>].}
20f0: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
2100: 44 45 4c 45 54 45 20 63 6f 6d 6d 61 6e 64 20 69  DELETE command i
2110: 73 20 75 73 65 64 20 74 6f 20 72 65 6d 6f 76 65  s used to remove
2120: 20 72 65 63 6f 72 64 73 20 66 72 6f 6d 20 61 20   records from a 
2130: 74 61 62 6c 65 2e 0a 54 68 65 20 63 6f 6d 6d 61  table..The comma
2140: 6e 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  nd consists of t
2150: 68 65 20 22 44 45 4c 45 54 45 20 46 52 4f 4d 22  he "DELETE FROM"
2160: 20 6b 65 79 77 6f 72 64 73 20 66 6f 6c 6c 6f 77   keywords follow
2170: 65 64 20 62 79 0a 74 68 65 20 6e 61 6d 65 20 6f  ed by.the name o
2180: 66 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f 6d  f the table from
2190: 20 77 68 69 63 68 20 72 65 63 6f 72 64 73 20 61   which records a
21a0: 72 65 20 74 6f 20 62 65 20 72 65 6d 6f 76 65 64  re to be removed
21b0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 57 69 74 68 6f  ..</p>..<p>Witho
21c0: 75 74 20 61 20 57 48 45 52 45 20 63 6c 61 75 73  ut a WHERE claus
21d0: 65 2c 20 61 6c 6c 20 72 6f 77 73 20 6f 66 20 74  e, all rows of t
21e0: 68 65 20 74 61 62 6c 65 20 61 72 65 20 72 65 6d  he table are rem
21f0: 6f 76 65 64 2e 0a 49 66 20 61 20 57 48 45 52 45  oved..If a WHERE
2200: 20 63 6c 61 75 73 65 20 69 73 20 73 75 70 70 6c   clause is suppl
2210: 69 65 64 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 74  ied, then only t
2220: 68 6f 73 65 20 72 6f 77 73 20 74 68 61 74 20 6d  hose rows that m
2230: 61 74 63 68 0a 74 68 65 20 65 78 70 72 65 73 73  atch.the express
2240: 69 6f 6e 20 61 72 65 20 72 65 6d 6f 76 65 64 2e  ion are removed.
2250: 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e  </p>.}...Section
2260: 20 7b 44 52 4f 50 20 49 4e 44 45 58 7d 20 64 72   {DROP INDEX} dr
2270: 6f 70 69 6e 64 65 78 0a 0a 53 79 6e 74 61 78 20  opindex..Syntax 
2280: 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a  {sql-command} {.
2290: 44 52 4f 50 20 49 4e 44 45 58 20 3c 69 6e 64 65  DROP INDEX <inde
22a0: 78 2d 6e 61 6d 65 3e 0a 7d 0a 0a 70 75 74 73 20  x-name>.}..puts 
22b0: 7b 0a 3c 70 3e 54 68 65 20 44 52 4f 50 20 49 4e  {.<p>The DROP IN
22c0: 44 45 58 20 73 74 61 74 65 6d 65 6e 74 20 63 6f  DEX statement co
22d0: 6e 73 69 73 74 73 20 6f 66 20 74 68 65 20 6b 65  nsists of the ke
22e0: 79 77 6f 72 64 73 20 22 44 52 4f 50 20 49 4e 44  ywords "DROP IND
22f0: 45 58 22 20 66 6f 6c 6c 6f 77 65 64 0a 62 79 20  EX" followed.by 
2300: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
2310: 69 6e 64 65 78 2e 20 20 54 68 65 20 69 6e 64 65  index.  The inde
2320: 78 20 6e 61 6d 65 64 20 69 73 20 63 6f 6d 70 6c  x named is compl
2330: 65 74 65 6c 79 20 72 65 6d 6f 76 65 64 20 66 72  etely removed fr
2340: 6f 6d 0a 74 68 65 20 64 69 73 6b 2e 20 20 54 68  om.the disk.  Th
2350: 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 72 65  e only way to re
2360: 63 6f 76 65 72 20 74 68 65 20 69 6e 64 65 78 20  cover the index 
2370: 69 73 20 74 6f 20 72 65 65 6e 74 65 72 20 74 68  is to reenter th
2380: 65 0a 61 70 70 72 6f 70 72 69 61 74 65 20 43 52  e.appropriate CR
2390: 45 41 54 45 20 49 4e 44 45 58 20 63 6f 6d 6d 61  EATE INDEX comma
23a0: 6e 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69  nd.</p>.}..Secti
23b0: 6f 6e 20 7b 44 52 4f 50 20 54 41 42 4c 45 7d 20  on {DROP TABLE} 
23c0: 64 72 6f 70 74 61 62 6c 65 0a 0a 53 79 6e 74 61  droptable..Synta
23d0: 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20  x {sql-command} 
23e0: 7b 0a 44 52 4f 50 20 54 41 42 4c 45 20 3c 74 61  {.DROP TABLE <ta
23f0: 62 6c 65 2d 6e 61 6d 65 3e 0a 7d 0a 0a 70 75 74  ble-name>.}..put
2400: 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52 4f 50 20  s {.<p>The DROP 
2410: 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 20  TABLE statement 
2420: 63 6f 6e 73 69 73 74 73 20 6f 66 20 74 68 65 20  consists of the 
2430: 6b 65 79 77 6f 72 64 73 20 22 44 52 4f 50 20 54  keywords "DROP T
2440: 41 42 4c 45 22 20 66 6f 6c 6c 6f 77 65 64 0a 62  ABLE" followed.b
2450: 79 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  y the name of th
2460: 65 20 74 61 62 6c 65 2e 20 20 54 68 65 20 74 61  e table.  The ta
2470: 62 6c 65 20 6e 61 6d 65 64 20 69 73 20 63 6f 6d  ble named is com
2480: 70 6c 65 74 65 6c 79 20 72 65 6d 6f 76 65 64 20  pletely removed 
2490: 66 72 6f 6d 0a 74 68 65 20 64 69 73 6b 2e 20 20  from.the disk.  
24a0: 54 68 65 20 74 61 62 6c 65 20 63 61 6e 20 6e 6f  The table can no
24b0: 74 20 62 65 20 72 65 63 6f 76 65 72 65 64 2e 20  t be recovered. 
24c0: 20 41 6c 6c 20 69 6e 64 69 63 65 73 20 61 73 73   All indices ass
24d0: 6f 63 69 61 74 65 64 20 77 69 74 68 0a 74 68 65  ociated with.the
24e0: 20 74 61 62 6c 65 20 61 72 65 20 61 6c 73 6f 20   table are also 
24f0: 64 65 6c 65 74 65 64 2e 3c 2f 70 3e 7d 0a 0a 53  deleted.</p>}..S
2500: 65 63 74 69 6f 6e 20 45 58 50 4c 41 49 4e 20 65  ection EXPLAIN e
2510: 78 70 6c 61 69 6e 0a 0a 53 79 6e 74 61 78 20 7b  xplain..Syntax {
2520: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
2530: 0a 45 58 50 4c 41 49 4e 20 3c 73 71 6c 2d 73 74  .EXPLAIN <sql-st
2540: 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73  atement>.}..puts
2550: 20 7b 0a 3c 70 3e 54 68 65 20 45 58 50 4c 41 49   {.<p>The EXPLAI
2560: 4e 20 63 6f 6d 6d 61 6e 64 20 6d 6f 64 69 66 69  N command modifi
2570: 65 72 20 69 73 20 61 20 6e 6f 6e 2d 73 74 61 6e  er is a non-stan
2580: 64 61 72 64 20 65 78 74 65 6e 73 69 6f 6e 2e 20  dard extension. 
2590: 20 54 68 65 0a 69 64 65 61 20 63 6f 6d 65 73 20   The.idea comes 
25a0: 66 72 6f 6d 20 61 20 73 69 6d 69 6c 61 72 20 63  from a similar c
25b0: 6f 6d 6d 61 6e 64 20 66 6f 75 6e 64 20 69 6e 20  ommand found in 
25c0: 50 6f 73 74 67 72 65 53 51 4c 2c 20 62 75 74 20  PostgreSQL, but 
25d0: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 0a 69 73  the operation.is
25e0: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 66 66   completely diff
25f0: 65 72 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49  erent.</p>..<p>I
2600: 66 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b 65  f the EXPLAIN ke
2610: 79 77 6f 72 64 20 61 70 70 65 61 72 73 20 62 65  yword appears be
2620: 66 6f 72 65 20 61 6e 79 20 6f 74 68 65 72 20 53  fore any other S
2630: 51 4c 69 74 65 20 53 51 4c 20 63 6f 6d 6d 61 6e  QLite SQL comman
2640: 64 0a 74 68 65 6e 20 69 6e 73 74 65 61 64 20 6f  d.then instead o
2650: 66 20 61 63 74 75 61 6c 6c 79 20 65 78 65 63 75  f actually execu
2660: 74 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64  ting the command
2670: 2c 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62  , the SQLite lib
2680: 72 61 72 79 20 77 69 6c 6c 0a 72 65 70 6f 72 74  rary will.report
2690: 20 62 61 63 6b 20 74 68 65 20 73 65 71 75 65 6e   back the sequen
26a0: 63 65 20 6f 66 20 76 69 72 74 75 61 6c 20 6d 61  ce of virtual ma
26b0: 63 68 69 6e 65 20 69 6e 73 74 72 75 63 74 69 6f  chine instructio
26c0: 6e 73 20 69 74 20 77 6f 75 6c 64 20 68 61 76 65  ns it would have
26d0: 0a 75 73 65 64 20 74 6f 20 65 78 65 63 75 74 65  .used to execute
26e0: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 68 61 64   the command had
26f0: 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b 65 79   the EXPLAIN key
2700: 77 6f 72 64 20 6e 6f 74 20 62 65 65 6e 20 70 72  word not been pr
2710: 65 73 65 6e 74 2e 0a 46 6f 72 20 61 64 64 69 74  esent..For addit
2720: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
2730: 6e 20 61 62 6f 75 74 20 76 69 72 74 75 61 6c 20  n about virtual 
2740: 6d 61 63 68 69 6e 65 20 69 6e 73 74 72 75 63 74  machine instruct
2750: 69 6f 6e 73 20 73 65 65 0a 74 68 65 20 3c 61 20  ions see.the <a 
2760: 68 72 65 66 3d 22 61 72 63 68 2e 68 74 6d 6c 22  href="arch.html"
2770: 3e 61 72 63 68 69 74 65 63 74 75 72 65 20 64 65  >architecture de
2780: 73 63 72 69 70 74 69 6f 6e 3c 2f 61 3e 20 6f 72  scription</a> or
2790: 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69   the documentati
27a0: 6f 6e 0a 6f 6e 20 3c 61 20 68 72 65 66 3d 22 6f  on.on <a href="o
27b0: 70 63 6f 64 65 2e 68 74 6d 6c 22 3e 61 76 61 69  pcode.html">avai
27c0: 6c 61 62 6c 65 20 6f 70 63 6f 64 65 73 3c 2f 61  lable opcodes</a
27d0: 3e 20 66 6f 72 20 74 68 65 20 76 69 72 74 75 61  > for the virtua
27e0: 6c 20 6d 61 63 68 69 6e 65 2e 3c 2f 70 3e 0a 7d  l machine.</p>.}
27f0: 0a 0a 53 65 63 74 69 6f 6e 20 65 78 70 72 65 73  ..Section expres
2800: 73 69 6f 6e 20 65 78 70 72 0a 0a 53 79 6e 74 61  sion expr..Synta
2810: 78 20 7b 65 78 70 72 65 73 73 69 6f 6e 7d 20 7b  x {expression} {
2820: 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 3c 62  .<expression> <b
2830: 69 6e 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 65  inary-op> <expre
2840: 73 73 69 6f 6e 3e 20 7c 0a 3c 65 78 70 72 65 73  ssion> |.<expres
2850: 73 69 6f 6e 3e 20 3c 6c 69 6b 65 2d 6f 70 3e 20  sion> <like-op> 
2860: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a 3c  <expression> |.<
2870: 75 6e 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 65  unary-op> <expre
2880: 73 73 69 6f 6e 3e 20 7c 0a 28 20 3c 65 78 70 72  ssion> |.( <expr
2890: 65 73 73 69 6f 6e 3e 20 29 20 7c 0a 3c 63 6f 6c  ession> ) |.<col
28a0: 75 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 74 61 62  umn-name> |.<tab
28b0: 6c 65 2d 6e 61 6d 65 3e 20 2e 20 3c 63 6f 6c 75  le-name> . <colu
28c0: 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 6c 69 74 65  mn-name> |.<lite
28d0: 72 61 6c 2d 76 61 6c 75 65 3e 20 7c 0a 3c 66 75  ral-value> |.<fu
28e0: 6e 63 74 69 6f 6e 2d 6e 61 6d 65 3e 20 28 20 3c  nction-name> ( <
28f0: 65 78 70 72 2d 6c 69 73 74 3e 20 7c 20 53 54 41  expr-list> | STA
2900: 52 20 29 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f  R ) |.<expressio
2910: 6e 3e 20 49 53 4e 55 4c 4c 20 7c 0a 3c 65 78 70  n> ISNULL |.<exp
2920: 72 65 73 73 69 6f 6e 3e 20 4e 4f 54 4e 55 4c 4c  ression> NOTNULL
2930: 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20   |.<expression> 
2940: 5b 4e 4f 54 5d 20 42 45 54 57 45 45 4e 20 3c 65  [NOT] BETWEEN <e
2950: 78 70 72 65 73 73 69 6f 6e 3e 20 41 4e 44 20 3c  xpression> AND <
2960: 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a 3c 65  expression> |.<e
2970: 78 70 72 65 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d  xpression> [NOT]
2980: 20 49 4e 20 28 20 3c 76 61 6c 75 65 2d 6c 69 73   IN ( <value-lis
2990: 74 3e 20 29 20 7c 0a 3c 65 78 70 72 65 73 73 69  t> ) |.<expressi
29a0: 6f 6e 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28 20 3c  on> [NOT] IN ( <
29b0: 73 65 6c 65 63 74 3e 20 29 20 7c 0a 28 20 3c 73  select> ) |.( <s
29c0: 65 6c 65 63 74 3e 20 29 0a 7d 20 7b 6c 69 6b 65  elect> ).} {like
29d0: 2d 6f 70 7d 20 7b 0a 4c 49 4b 45 20 7c 20 47 4c  -op} {.LIKE | GL
29e0: 4f 42 20 7c 20 4e 4f 54 20 4c 49 4b 45 20 7c 20  OB | NOT LIKE | 
29f0: 4e 4f 54 20 47 4c 4f 42 0a 7d 0a 0a 70 75 74 73  NOT GLOB.}..puts
2a00: 20 7b 0a 3c 70 3e 54 68 69 73 20 73 65 63 74 69   {.<p>This secti
2a10: 6f 6e 20 69 73 20 64 69 66 66 65 72 65 6e 74 20  on is different 
2a20: 66 72 6f 6d 20 74 68 65 20 6f 74 68 65 72 73 2e  from the others.
2a30: 20 20 45 76 65 72 79 20 6f 74 68 65 72 20 73 65    Every other se
2a40: 63 74 69 6f 6e 20 6f 66 0a 74 68 69 73 20 64 6f  ction of.this do
2a50: 63 75 6d 65 6e 74 20 74 61 6c 6b 73 20 61 62 6f  cument talks abo
2a60: 75 74 20 61 20 70 61 72 74 69 63 75 6c 61 72 20  ut a particular 
2a70: 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68  SQL command.  Th
2a80: 69 73 20 73 65 63 74 69 6f 6e 20 64 6f 65 73 0a  is section does.
2a90: 6e 6f 74 20 74 61 6c 6b 20 61 62 6f 75 74 20 61  not talk about a
2aa0: 20 73 74 61 6e 64 61 6c 6f 6e 65 20 63 6f 6d 6d   standalone comm
2ab0: 61 6e 64 20 62 75 74 20 61 62 6f 75 74 20 22 65  and but about "e
2ac0: 78 70 72 65 73 73 69 6f 6e 73 22 20 77 68 69 63  xpressions" whic
2ad0: 68 20 61 72 65 20 0a 73 75 62 63 6f 6d 70 6f 6e  h are .subcompon
2ae0: 65 6e 74 20 6f 66 20 6d 6f 73 74 20 6f 74 68 65  ent of most othe
2af0: 72 20 63 6f 6d 6d 61 6e 64 73 2e 3c 2f 70 3e 0a  r commands.</p>.
2b00: 0a 3c 70 3e 53 51 4c 69 74 65 20 75 6e 64 65 72  .<p>SQLite under
2b10: 73 74 61 6e 64 73 20 74 68 65 20 66 6f 6c 6c 6f  stands the follo
2b20: 77 69 6e 67 20 62 69 6e 61 72 79 20 6f 70 65 72  wing binary oper
2b30: 61 74 6f 72 73 2c 20 69 6e 20 6f 72 64 65 72 20  ators, in order 
2b40: 66 72 6f 6d 0a 68 69 67 68 65 73 74 20 74 6f 20  from.highest to 
2b50: 6c 6f 77 65 73 74 20 70 72 65 63 65 64 65 6e 63  lowest precedenc
2b60: 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  e:</p>..<blockqu
2b70: 6f 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e 74 20  ote><pre>.<font 
2b80: 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e  color="#2c2cf0">
2b90: 3c 62 69 67 3e 2a 20 20 20 20 2f 0a 2b 20 20 20  <big>*    /.+   
2ba0: 20 2d 0a 26 6c 74 3b 20 20 20 20 26 6c 74 3b 3d   -.&lt;    &lt;=
2bb0: 20 20 20 26 67 74 3b 20 20 20 20 26 67 74 3b 3d     &gt;    &gt;=
2bc0: 0a 3d 20 20 20 20 3d 3d 20 20 20 21 3d 20 20 20  .=    ==   !=   
2bd0: 26 6c 74 3b 26 67 74 3b 20 20 20 3c 2f 62 69 67  &lt;&gt;   </big
2be0: 3e 49 4e 0a 41 4e 44 0a 4f 52 3c 2f 66 6f 6e 74  >IN.AND.OR</font
2bf0: 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71  >.</pre></blockq
2c00: 75 6f 74 65 3e 0a 0a 3c 70 3e 41 6e 79 20 53 51  uote>..<p>Any SQ
2c10: 4c 69 74 65 20 76 61 6c 75 65 20 63 61 6e 20 62  Lite value can b
2c20: 65 20 75 73 65 64 20 61 73 20 70 61 72 74 20 6f  e used as part o
2c30: 66 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 2e  f an expression.
2c40: 20 20 0a 46 6f 72 20 61 72 69 74 68 6d 65 74 69    .For arithmeti
2c50: 63 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20 69 6e  c operations, in
2c60: 74 65 67 65 72 73 20 61 72 65 20 74 72 65 61 74  tegers are treat
2c70: 65 64 20 61 73 20 69 6e 74 65 67 65 72 73 2e 0a  ed as integers..
2c80: 53 74 72 69 6e 67 73 20 61 72 65 20 66 69 72 73  Strings are firs
2c90: 74 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 72  t converted to r
2ca0: 65 61 6c 20 6e 75 6d 62 65 72 73 20 75 73 69 6e  eal numbers usin
2cb0: 67 20 3c 62 3e 61 74 6f 66 28 29 3c 2f 62 3e 2e  g <b>atof()</b>.
2cc0: 0a 46 6f 72 20 63 6f 6d 70 61 72 69 73 6f 6e 20  .For comparison 
2cd0: 6f 70 65 72 61 74 6f 72 73 2c 20 6e 75 6d 62 65  operators, numbe
2ce0: 72 73 20 63 6f 6d 70 61 72 65 20 61 73 20 6e 75  rs compare as nu
2cf0: 6d 62 65 72 73 20 61 6e 64 20 73 74 72 69 6e 67  mbers and string
2d00: 73 0a 63 6f 6d 70 61 72 65 20 61 73 20 73 74 72  s.compare as str
2d10: 69 6e 67 73 2e 20 20 46 6f 72 20 73 74 72 69 6e  ings.  For strin
2d20: 67 20 63 6f 6d 70 61 72 69 73 6f 6e 73 2c 20 63  g comparisons, c
2d30: 61 73 65 20 69 73 20 73 69 67 6e 69 66 69 63 61  ase is significa
2d40: 6e 74 0a 62 75 74 20 69 73 20 6f 6e 6c 79 20 75  nt.but is only u
2d50: 73 65 64 20 74 6f 20 62 72 65 61 6b 20 61 20 74  sed to break a t
2d60: 69 65 2e 0a 4e 6f 74 65 20 74 68 61 74 20 74 68  ie..Note that th
2d70: 65 72 65 20 61 72 65 20 74 77 6f 20 76 61 72 69  ere are two vari
2d80: 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 65 71  ations of the eq
2d90: 75 61 6c 73 20 61 6e 64 20 6e 6f 74 20 65 71 75  uals and not equ
2da0: 61 6c 73 0a 6f 70 65 72 61 74 6f 72 73 2e 20 20  als.operators.  
2db0: 45 71 75 61 6c 73 20 63 61 6e 20 62 65 20 65 69  Equals can be ei
2dc0: 74 68 65 72 7d 0a 70 75 74 73 20 22 5b 4f 70 65  ther}.puts "[Ope
2dd0: 72 61 74 6f 72 20 3d 5d 20 6f 72 20 5b 4f 70 65  rator =] or [Ope
2de0: 72 61 74 6f 72 20 3d 3d 5d 2e 0a 54 68 65 20 6e  rator ==]..The n
2df0: 6f 6e 2d 65 71 75 61 6c 73 20 6f 70 65 72 61 74  on-equals operat
2e00: 6f 72 20 63 61 6e 20 62 65 20 65 69 74 68 65 72  or can be either
2e10: 0a 5b 4f 70 65 72 61 74 6f 72 20 21 3d 5d 20 6f  .[Operator !=] o
2e20: 72 20 5b 4f 70 65 72 61 74 6f 72 20 7b 26 6c 74  r [Operator {&lt
2e30: 3b 26 67 74 3b 7d 5d 2e 3c 2f 70 3e 22 0a 70 75  ;&gt;}].</p>".pu
2e40: 74 73 20 7b 0a 0a 3c 70 3e 54 68 65 20 4c 49 4b  ts {..<p>The LIK
2e50: 45 20 6f 70 65 72 61 74 6f 72 20 64 6f 65 73 20  E operator does 
2e60: 61 20 77 69 6c 64 63 61 72 64 20 63 6f 6d 70 61  a wildcard compa
2e70: 72 69 73 69 6f 6e 2e 20 20 54 68 65 20 6f 70 65  rision.  The ope
2e80: 72 61 6e 64 0a 74 6f 20 74 68 65 20 72 69 67 68  rand.to the righ
2e90: 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 77  t contains the w
2ea0: 69 6c 64 63 61 72 64 73 2e 7d 0a 70 75 74 73 20  ildcards.}.puts 
2eb0: 22 41 20 70 65 72 63 65 6e 74 20 73 79 6d 62 6f  "A percent symbo
2ec0: 6c 20 5b 4f 70 65 72 61 74 6f 72 20 25 5d 20 69  l [Operator %] i
2ed0: 6e 20 74 68 65 20 72 69 67 68 74 20 6f 70 65 72  n the right oper
2ee0: 61 6e 64 0a 6d 61 74 63 68 65 73 20 61 6e 79 20  and.matches any 
2ef0: 73 65 71 75 65 6e 63 65 20 6f 66 20 7a 65 72 6f  sequence of zero
2f00: 20 6f 72 20 6d 6f 72 65 20 63 68 61 72 61 63 74   or more charact
2f10: 65 72 73 20 6f 6e 20 74 68 65 20 6c 65 66 74 2e  ers on the left.
2f20: 0a 41 6e 20 75 6e 64 65 72 73 63 6f 72 65 20 5b  .An underscore [
2f30: 4f 70 65 72 61 74 6f 72 20 5f 5d 20 6f 6e 20 74  Operator _] on t
2f40: 68 65 20 72 69 67 68 74 0a 6d 61 74 63 68 65 73  he right.matches
2f50: 20 61 6e 79 20 73 69 6e 67 6c 65 20 63 68 61 72   any single char
2f60: 61 63 74 65 72 20 6f 6e 20 74 68 65 20 6c 65 66  acter on the lef
2f70: 74 2e 22 0a 70 75 74 73 20 7b 54 68 65 20 4c 49  t.".puts {The LI
2f80: 4b 45 20 6f 70 65 72 61 74 6f 72 20 69 73 0a 6e  KE operator is.n
2f90: 6f 74 20 63 61 73 65 20 73 65 6e 73 69 74 69 76  ot case sensitiv
2fa0: 65 20 61 6e 64 20 77 69 6c 6c 20 6d 61 74 63 68  e and will match
2fb0: 20 75 70 70 65 72 20 63 61 73 65 20 63 68 61 72   upper case char
2fc0: 61 63 74 65 72 73 20 6f 6e 20 6f 6e 65 0a 73 69  acters on one.si
2fd0: 64 65 20 61 67 61 69 6e 73 74 20 6c 6f 77 65 72  de against lower
2fe0: 20 63 61 73 65 20 63 68 61 72 61 63 74 65 72 73   case characters
2ff0: 20 6f 6e 20 74 68 65 20 6f 74 68 65 72 2e 0a 28   on the other..(
3000: 41 20 62 75 67 3a 20 53 51 4c 69 74 65 20 6f 6e  A bug: SQLite on
3010: 6c 79 20 75 6e 64 65 72 73 74 61 6e 64 73 20 75  ly understands u
3020: 70 70 65 72 2f 6c 6f 77 65 72 20 63 61 73 65 20  pper/lower case 
3030: 66 6f 72 20 37 2d 62 69 74 20 4c 61 74 69 6e 0a  for 7-bit Latin.
3040: 63 68 61 72 61 63 74 65 72 73 2e 20 20 48 65 6e  characters.  Hen
3050: 63 65 20 74 68 65 20 4c 49 4b 45 20 6f 70 65 72  ce the LIKE oper
3060: 61 74 6f 72 20 69 73 20 63 61 73 65 20 73 65 6e  ator is case sen
3070: 73 69 74 69 76 65 20 66 6f 72 0a 38 2d 62 69 74  sitive for.8-bit
3080: 20 69 73 6f 38 38 35 39 20 63 68 61 72 61 63 74   iso8859 charact
3090: 65 72 73 20 6f 72 20 55 54 46 2d 38 20 63 68 61  ers or UTF-8 cha
30a0: 72 61 63 74 65 72 73 2e 20 20 46 6f 72 20 65 78  racters.  For ex
30b0: 61 6d 70 6c 65 2c 0a 74 68 65 20 65 78 70 72 65  ample,.the expre
30c0: 73 73 69 6f 6e 20 3c 62 3e 27 61 27 26 6e 62 73  ssion <b>'a'&nbs
30d0: 70 3b 4c 49 4b 45 26 6e 62 73 70 3b 27 41 27 3c  p;LIKE&nbsp;'A'<
30e0: 2f 62 3e 20 69 73 20 54 52 55 45 20 62 75 74 0a  /b> is TRUE but.
30f0: 3c 62 3e 27 26 61 65 6c 69 67 3b 27 26 6e 62 73  <b>'&aelig;'&nbs
3100: 70 3b 4c 49 4b 45 26 6e 62 73 70 3b 27 26 41 45  p;LIKE&nbsp;'&AE
3110: 6c 69 67 3b 27 3c 2f 62 3e 20 69 73 20 46 41 4c  lig;'</b> is FAL
3120: 53 45 2e 29 0a 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  SE.).</p>..<p>Th
3130: 65 20 47 4c 4f 42 20 6f 70 65 72 61 74 6f 72 20  e GLOB operator 
3140: 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 4c 49  is similar to LI
3150: 4b 45 20 62 75 74 20 75 73 65 73 20 74 68 65 20  KE but uses the 
3160: 55 6e 69 78 0a 66 69 6c 65 20 67 6c 6f 62 62 69  Unix.file globbi
3170: 6e 67 20 73 79 6e 74 61 78 20 66 6f 72 20 69 74  ng syntax for it
3180: 73 20 77 69 6c 64 63 61 72 64 73 2e 20 20 41 6c  s wildcards.  Al
3190: 73 6f 2c 20 47 4c 4f 42 20 69 73 20 63 61 73 65  so, GLOB is case
31a0: 0a 73 65 6e 73 69 74 69 76 65 2c 20 75 6e 6c 69  .sensitive, unli
31b0: 6b 65 20 4c 49 4b 45 2e 20 20 42 6f 74 68 20 47  ke LIKE.  Both G
31c0: 4c 4f 42 20 61 6e 64 20 4c 49 4b 45 20 6d 61 79  LOB and LIKE may
31d0: 20 62 65 20 70 72 65 63 65 64 65 64 20 62 79 0a   be preceded by.
31e0: 74 68 65 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20  the NOT keyword 
31f0: 74 6f 20 69 6e 76 65 72 74 20 74 68 65 20 73 65  to invert the se
3200: 6e 73 65 20 6f 66 20 74 68 65 20 74 65 73 74 2e  nse of the test.
3210: 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 63 6f 6c 75 6d  </p>..<p>A colum
3220: 6e 20 6e 61 6d 65 20 63 61 6e 20 62 65 20 61 6e  n name can be an
3230: 79 20 6f 66 20 74 68 65 20 6e 61 6d 65 73 20 64  y of the names d
3240: 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 43 52  efined in the CR
3250: 45 41 54 45 20 54 41 42 4c 45 0a 73 74 61 74 65  EATE TABLE.state
3260: 6d 65 6e 74 20 6f 72 20 6f 6e 65 20 6f 66 20 74  ment or one of t
3270: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 70 65  he following spe
3280: 63 69 61 6c 20 69 64 65 6e 74 69 66 69 65 72 73  cial identifiers
3290: 3a 20 22 3c 62 3e 52 4f 57 49 44 3c 2f 62 3e 22  : "<b>ROWID</b>"
32a0: 2c 0a 22 3c 62 3e 4f 49 44 3c 2f 62 3e 22 2c 20  ,."<b>OID</b>", 
32b0: 6f 72 20 22 3c 62 3e 5f 52 4f 57 49 44 5f 3c 2f  or "<b>_ROWID_</
32c0: 62 3e 22 2e 0a 54 68 65 73 65 20 73 70 65 63 69  b>"..These speci
32d0: 61 6c 20 69 64 65 6e 74 69 66 69 65 72 73 20 61  al identifiers a
32e0: 6c 6c 20 64 65 73 63 72 69 62 65 20 74 68 65 0a  ll describe the.
32f0: 75 6e 69 71 75 65 20 72 61 6e 64 6f 6d 20 69 6e  unique random in
3300: 74 65 67 65 72 20 6b 65 79 20 28 74 68 65 20 22  teger key (the "
3310: 72 6f 77 20 6b 65 79 22 29 20 61 73 73 6f 63 69  row key") associ
3320: 61 74 65 64 20 77 69 74 68 20 65 76 65 72 79 20  ated with every 
3330: 0a 72 6f 77 20 6f 66 20 65 76 65 72 79 20 74 61  .row of every ta
3340: 62 6c 65 2e 0a 54 68 65 20 73 70 65 63 69 61 6c  ble..The special
3350: 20 69 64 65 6e 74 69 66 69 65 72 73 20 6f 6e 6c   identifiers onl
3360: 79 20 72 65 66 65 72 20 74 6f 20 74 68 65 20 72  y refer to the r
3370: 6f 77 20 6b 65 79 20 69 66 20 74 68 65 20 43 52  ow key if the CR
3380: 45 41 54 45 20 54 41 42 4c 45 0a 73 74 61 74 65  EATE TABLE.state
3390: 6d 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20 64 65  ment does not de
33a0: 66 69 6e 65 20 61 20 72 65 61 6c 20 63 6f 6c 75  fine a real colu
33b0: 6d 6e 20 77 69 74 68 20 74 68 65 20 73 61 6d 65  mn with the same
33c0: 20 6e 61 6d 65 2e 20 20 52 6f 77 20 6b 65 79 73   name.  Row keys
33d0: 0a 61 63 74 20 6c 69 6b 65 20 72 65 61 64 2d 6f  .act like read-o
33e0: 6e 6c 79 20 63 6f 6c 75 6d 6e 73 2e 20 20 41 20  nly columns.  A 
33f0: 72 6f 77 20 6b 65 79 20 63 61 6e 20 62 65 20 75  row key can be u
3400: 73 65 64 20 61 6e 79 77 68 65 72 65 20 61 20 72  sed anywhere a r
3410: 65 67 75 6c 61 72 0a 63 6f 6c 75 6d 6e 20 63 61  egular.column ca
3420: 6e 20 62 65 20 75 73 65 64 2c 20 65 78 63 65 70  n be used, excep
3430: 74 20 74 68 61 74 20 79 6f 75 20 63 61 6e 6e 6f  t that you canno
3440: 74 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c  t change the val
3450: 75 65 0a 6f 66 20 61 20 72 6f 77 20 6b 65 79 20  ue.of a row key 
3460: 69 6e 20 61 6e 20 55 50 44 41 54 45 20 6f 72 20  in an UPDATE or 
3470: 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74  INSERT statement
3480: 2e 0a 22 53 45 4c 45 43 54 20 2a 20 2e 2e 2e 22  .."SELECT * ..."
3490: 20 64 6f 65 73 20 6e 6f 74 20 72 65 74 75 72 6e   does not return
34a0: 20 74 68 65 20 72 6f 77 20 6b 65 79 2e 3c 2f 70   the row key.</p
34b0: 3e 0a 0a 3c 70 3e 53 45 4c 45 43 54 20 73 74 61  >..<p>SELECT sta
34c0: 74 65 6d 65 6e 74 73 20 63 61 6e 20 61 70 70 65  tements can appe
34d0: 61 72 20 69 6e 20 65 78 70 72 65 73 73 69 6f 6e  ar in expression
34e0: 73 20 61 73 20 65 69 74 68 65 72 20 74 68 65 0a  s as either the.
34f0: 72 69 67 68 74 2d 68 61 6e 64 20 6f 70 65 72 61  right-hand opera
3500: 6e 64 20 6f 66 20 74 68 65 20 49 4e 20 6f 70 65  nd of the IN ope
3510: 72 61 74 6f 72 20 6f 72 20 61 73 20 61 20 73 63  rator or as a sc
3520: 61 6c 61 72 20 71 75 61 6e 74 69 74 79 2e 0a 49  alar quantity..I
3530: 6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20 74 68  n both cases, th
3540: 65 20 53 45 4c 45 43 54 20 73 68 6f 75 6c 64 20  e SELECT should 
3550: 68 61 76 65 20 6f 6e 6c 79 20 61 20 73 69 6e 67  have only a sing
3560: 6c 65 20 63 6f 6c 75 6d 6e 20 69 6e 20 69 74 73  le column in its
3570: 0a 72 65 73 75 6c 74 2e 20 20 43 6f 6d 70 6f 75  .result.  Compou
3580: 6e 64 20 53 45 4c 45 43 54 73 20 28 63 6f 6e 6e  nd SELECTs (conn
3590: 65 63 74 65 64 20 77 69 74 68 20 6b 65 79 77 6f  ected with keywo
35a0: 72 64 73 20 6c 69 6b 65 20 55 4e 49 4f 4e 20 6f  rds like UNION o
35b0: 72 0a 45 58 43 45 50 54 29 20 61 72 65 20 61 6c  r.EXCEPT) are al
35c0: 6c 6f 77 65 64 2e 20 20 41 6e 79 20 4f 52 44 45  lowed.  Any ORDE
35d0: 52 20 42 59 20 63 6c 61 75 73 65 20 6f 6e 20 74  R BY clause on t
35e0: 68 65 20 73 65 6c 65 63 74 20 69 73 20 69 67 6e  he select is ign
35f0: 6f 72 65 64 2e 0a 41 20 53 45 4c 45 43 54 20 69  ored..A SELECT i
3600: 6e 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  n an expression 
3610: 69 73 20 65 76 61 6c 75 61 74 65 64 20 6f 6e 63  is evaluated onc
3620: 65 20 62 65 66 6f 72 65 20 61 6e 79 20 6f 74 68  e before any oth
3630: 65 72 20 70 72 6f 63 65 73 73 69 6e 67 0a 69 73  er processing.is
3640: 20 70 65 72 66 6f 72 6d 65 64 2c 20 73 6f 20 6e   performed, so n
3650: 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 70 72 65  one of the expre
3660: 73 73 69 6f 6e 73 20 77 69 74 68 69 6e 20 74 68  ssions within th
3670: 65 20 73 65 6c 65 63 74 20 69 74 73 65 6c 66 20  e select itself 
3680: 63 61 6e 0a 72 65 66 65 72 20 74 6f 20 71 75 61  can.refer to qua
3690: 6e 74 69 74 69 65 73 20 69 6e 20 74 68 65 20 63  ntities in the c
36a0: 6f 6e 74 61 69 6e 69 6e 67 20 65 78 70 72 65 73  ontaining expres
36b0: 73 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68  sion.</p>..<p>Wh
36c0: 65 6e 20 61 20 53 45 4c 45 43 54 20 69 73 20 74  en a SELECT is t
36d0: 68 65 20 72 69 67 68 74 20 6f 70 65 72 61 6e 64  he right operand
36e0: 20 6f 66 20 74 68 65 20 49 4e 20 6f 70 65 72 61   of the IN opera
36f0: 74 6f 72 2c 20 74 68 65 20 49 4e 0a 6f 70 65 72  tor, the IN.oper
3700: 61 74 6f 72 20 72 65 74 75 72 6e 73 20 54 52 55  ator returns TRU
3710: 45 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20  E if the result 
3720: 6f 66 20 74 68 65 20 6c 65 66 74 20 6f 70 65 72  of the left oper
3730: 61 6e 64 20 69 73 20 61 6e 79 20 6f 66 0a 74 68  and is any of.th
3740: 65 20 76 61 6c 75 65 73 20 67 65 6e 65 72 61 74  e values generat
3750: 65 64 20 62 79 20 74 68 65 20 73 65 6c 65 63 74  ed by the select
3760: 2e 20 20 54 68 65 20 49 4e 20 6f 70 65 72 61 74  .  The IN operat
3770: 6f 72 20 6d 61 79 20 62 65 20 70 72 65 63 65 64  or may be preced
3780: 65 64 0a 62 79 20 74 68 65 20 4e 4f 54 20 6b 65  ed.by the NOT ke
3790: 79 77 6f 72 64 20 74 6f 20 69 6e 76 65 72 74 20  yword to invert 
37a0: 74 68 65 20 73 65 6e 73 65 20 6f 66 20 74 68 65  the sense of the
37b0: 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57   test.</p>..<p>W
37c0: 68 65 6e 20 61 20 53 45 4c 45 43 54 20 61 70 70  hen a SELECT app
37d0: 65 61 72 73 20 77 69 74 68 69 6e 20 61 6e 20 65  ears within an e
37e0: 78 70 72 65 73 73 69 6f 6e 20 62 75 74 20 69 73  xpression but is
37f0: 20 6e 6f 74 20 74 68 65 20 72 69 67 68 74 0a 6f   not the right.o
3800: 70 65 72 61 6e 64 20 6f 66 20 61 6e 20 49 4e 20  perand of an IN 
3810: 6f 70 65 72 61 74 6f 72 2c 20 74 68 65 6e 20 74  operator, then t
3820: 68 65 20 66 69 72 73 74 20 72 6f 77 20 6f 66 20  he first row of 
3830: 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68  the result of th
3840: 65 0a 53 45 4c 45 43 54 20 62 65 63 6f 6d 65 73  e.SELECT becomes
3850: 20 74 68 65 20 76 61 6c 75 65 20 75 73 65 64 20   the value used 
3860: 69 6e 20 74 68 65 20 65 78 70 72 65 73 73 69 6f  in the expressio
3870: 6e 2e 20 20 49 66 20 74 68 65 20 53 45 4c 45 43  n.  If the SELEC
3880: 54 20 79 69 65 6c 64 73 0a 6d 6f 72 65 20 74 68  T yields.more th
3890: 61 6e 20 6f 6e 65 20 72 65 73 75 6c 74 20 72 6f  an one result ro
38a0: 77 2c 20 61 6c 6c 20 72 6f 77 73 20 61 66 74 65  w, all rows afte
38b0: 72 20 74 68 65 20 66 69 72 73 74 20 61 72 65 20  r the first are 
38c0: 69 67 6e 6f 72 65 64 2e 20 20 49 66 0a 74 68 65  ignored.  If.the
38d0: 20 53 45 4c 45 43 54 20 79 65 69 6c 64 73 20 6e   SELECT yeilds n
38e0: 6f 20 72 6f 77 73 2c 20 74 68 65 6e 20 74 68 65  o rows, then the
38f0: 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 53 45   value of the SE
3900: 4c 45 43 54 20 69 73 20 4e 55 4c 4c 2e 3c 2f 70  LECT is NULL.</p
3910: 3e 0a 0a 3c 70 3e 54 68 65 20 65 78 70 72 65 73  >..<p>The expres
3920: 73 69 6f 6e 20 73 79 6e 74 61 78 20 63 75 72 72  sion syntax curr
3930: 65 6e 74 6c 79 20 73 75 70 70 6f 72 74 73 20 74  ently supports t
3940: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 66 75 6e  he following.fun
3950: 63 74 69 6f 6e 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c  ctions:</p>..<bl
3960: 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 3c  ockquote><pre>.<
3970: 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32  font color="#2c2
3980: 63 66 30 22 3e 3c 62 69 67 3e 63 6f 75 6e 74 20  cf0"><big>count 
3990: 20 20 20 6d 69 6e 20 20 20 20 20 20 20 6d 61 78     min       max
39a0: 20 20 20 20 20 20 20 73 75 6d 0a 61 76 67 20 20         sum.avg  
39b0: 20 20 20 20 6c 65 6e 67 74 68 20 20 20 20 73 75      length    su
39c0: 62 73 74 72 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74  bstr</big></font
39d0: 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71  >.</pre></blockq
39e0: 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66  uote>..<p>.The f
39f0: 75 6e 63 74 69 6f 6e 73 20 3c 62 3e 63 6f 75 6e  unctions <b>coun
3a00: 74 3c 2f 62 3e 2c 20 3c 62 3e 73 75 6d 3c 2f 62  t</b>, <b>sum</b
3a10: 3e 2c 20 61 6e 64 20 3c 62 3e 61 76 67 3c 2f 62  >, and <b>avg</b
3a20: 3e 20 61 6e 64 20 74 68 65 20 66 75 6e 63 74 69  > and the functi
3a30: 6f 6e 73 0a 3c 62 3e 6d 69 6e 3c 2f 62 3e 20 61  ons.<b>min</b> a
3a40: 6e 64 20 3c 62 3e 6d 61 78 3c 2f 62 3e 20 75 73  nd <b>max</b> us
3a50: 65 64 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65  ed with only one
3a60: 20 61 72 67 75 6d 65 6e 74 20 61 72 65 20 61 6c   argument are al
3a70: 6c 20 61 67 67 72 65 67 61 74 65 0a 66 75 6e 63  l aggregate.func
3a80: 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 6d 65 61  tions.  This mea
3a90: 6e 73 20 74 68 61 74 20 74 68 65 79 20 61 72 65  ns that they are
3aa0: 20 63 6f 6d 70 75 74 65 64 20 61 63 72 6f 73 73   computed across
3ab0: 20 61 6c 6c 20 72 6f 77 73 20 6f 66 20 74 68 65   all rows of the
3ac0: 20 72 65 73 75 6c 74 2e 0a 54 68 65 20 66 75 6e   result..The fun
3ad0: 63 74 69 6f 6e 73 20 3c 62 3e 6d 69 6e 3c 2f 62  ctions <b>min</b
3ae0: 3e 20 61 6e 64 20 3c 62 3e 6d 61 78 3c 2f 62 3e  > and <b>max</b>
3af0: 0a 77 69 74 68 20 74 77 6f 20 6f 72 20 6d 6f 72  .with two or mor
3b00: 65 20 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 20  e arguments and 
3b10: 74 68 65 20 0a 66 75 6e 63 74 69 6f 6e 73 20 3c  the .functions <
3b20: 62 3e 6c 65 6e 67 74 68 3c 2f 62 3e 20 61 6e 64  b>length</b> and
3b30: 20 3c 62 3e 73 75 62 73 74 72 3c 2f 62 3e 0a 61   <b>substr</b>.a
3b40: 72 65 20 6e 6f 6e 2d 61 67 67 72 65 67 61 74 65  re non-aggregate
3b50: 73 2e 20 20 4e 6f 6e 2d 61 67 67 72 65 67 61 74  s.  Non-aggregat
3b60: 65 20 66 75 6e 63 74 69 6f 6e 73 0a 61 72 65 20  e functions.are 
3b70: 63 6f 6d 70 75 74 65 64 20 73 65 70 61 72 61 74  computed separat
3b80: 65 6c 79 20 66 6f 72 20 65 61 63 68 20 72 6f 77  ely for each row
3b90: 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 2e 0a   of the result..
3ba0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 22 3c  </p>..<p>.The "<
3bb0: 62 3e 63 6f 75 6e 74 28 2a 29 3c 2f 62 3e 22 20  b>count(*)</b>" 
3bc0: 73 79 6e 74 61 78 20 69 73 20 73 75 70 70 6f 72  syntax is suppor
3bd0: 74 65 64 20 62 75 74 0a 22 3c 62 3e 63 6f 75 6e  ted but."<b>coun
3be0: 74 28 64 69 73 74 69 6e 63 74 3c 2f 62 3e 20 3c  t(distinct</b> <
3bf0: 69 3e 43 4f 4c 55 4d 4e 2d 4e 41 4d 45 3c 2f 69  i>COLUMN-NAME</i
3c00: 3e 3c 62 3e 29 3c 2f 62 3e 22 20 69 73 20 6e 6f  ><b>)</b>" is no
3c10: 74 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69  t..</p>.}..Secti
3c20: 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73 65 72 74  on INSERT insert
3c30: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
3c40: 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e 53 45 52  atement} {.INSER
3c50: 54 20 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61  T INTO <table-na
3c60: 6d 65 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c  me> [( <column-l
3c70: 69 73 74 3e 20 29 5d 20 56 41 4c 55 45 53 20 28  ist> )] VALUES (
3c80: 20 3c 76 61 6c 75 65 2d 6c 69 73 74 3e 20 29 20   <value-list> ) 
3c90: 7c 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 3c 74  |.INSERT INTO <t
3ca0: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63  able-name> [( <c
3cb0: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 3c  olumn-list> )] <
3cc0: 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74  select-statement
3cd0: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  >.}..puts {.<p>T
3ce0: 68 65 20 49 4e 53 45 52 54 20 73 74 61 74 65 6d  he INSERT statem
3cf0: 65 6e 74 20 63 6f 6d 65 73 20 69 6e 20 74 77 6f  ent comes in two
3d00: 20 62 61 73 69 63 20 66 6f 72 6d 73 2e 20 20 54   basic forms.  T
3d10: 68 65 20 66 69 72 73 74 20 66 6f 72 6d 0a 28 77  he first form.(w
3d20: 69 74 68 20 74 68 65 20 22 56 41 4c 55 45 53 22  ith the "VALUES"
3d30: 20 6b 65 79 77 6f 72 64 29 20 63 72 65 61 74 65   keyword) create
3d40: 73 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 20 72  s a single new r
3d50: 6f 77 20 69 6e 20 61 6e 20 65 78 69 73 74 69 6e  ow in an existin
3d60: 67 20 74 61 62 6c 65 2e 0a 49 66 20 6e 6f 20 63  g table..If no c
3d70: 6f 6c 75 6d 6e 2d 6c 69 73 74 20 69 73 20 73 70  olumn-list is sp
3d80: 65 63 69 66 69 65 64 20 74 68 65 6e 20 74 68 65  ecified then the
3d90: 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65   number of value
3da0: 73 20 6d 75 73 74 0a 62 65 20 74 68 65 20 73 61  s must.be the sa
3db0: 6d 65 20 61 73 20 74 68 65 20 6e 75 6d 62 65 72  me as the number
3dc0: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
3dd0: 68 65 20 74 61 62 6c 65 2e 20 20 49 66 20 61 20  he table.  If a 
3de0: 63 6f 6c 75 6d 6e 2d 6c 69 73 74 0a 69 73 20 73  column-list.is s
3df0: 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 74  pecified, then t
3e00: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c  he number of val
3e10: 75 65 73 20 6d 75 73 74 20 6d 61 74 63 68 20 74  ues must match t
3e20: 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 73 70 65  he number of.spe
3e30: 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 73 2e 20  cified columns. 
3e40: 20 43 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20   Columns of the 
3e50: 74 61 62 6c 65 20 74 68 61 74 20 64 6f 20 6e 6f  table that do no
3e60: 74 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 0a  t appear in the.
3e70: 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 61 72 65 20  column list are 
3e80: 66 69 6c 6c 20 77 69 74 68 20 74 68 65 20 64 65  fill with the de
3e90: 66 61 75 6c 74 20 76 61 6c 75 65 2c 20 6f 72 20  fault value, or 
3ea0: 77 69 74 68 20 4e 55 4c 4c 20 69 66 20 6e 6f 74  with NULL if not
3eb0: 0a 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69  .default value i
3ec0: 73 20 73 70 65 63 69 66 69 65 64 2e 0a 3c 2f 70  s specified..</p
3ed0: 3e 0a 0a 3c 70 3e 54 68 65 20 73 65 63 6f 6e 64  >..<p>The second
3ee0: 20 66 6f 72 6d 20 6f 66 20 74 68 65 20 49 4e 53   form of the INS
3ef0: 45 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 61  ERT statement ta
3f00: 6b 65 73 20 69 74 20 64 61 74 61 20 66 72 6f 6d  kes it data from
3f10: 20 61 0a 53 45 4c 45 43 54 20 73 74 61 74 65 6d   a.SELECT statem
3f20: 65 6e 74 2e 20 20 54 68 65 20 6e 75 6d 62 65 72  ent.  The number
3f30: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
3f40: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65  he result of the
3f50: 0a 53 45 4c 45 43 54 20 6d 75 73 74 20 65 78 61  .SELECT must exa
3f60: 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 6e  ctly match the n
3f70: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
3f80: 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 69 66   in the table if
3f90: 0a 6e 6f 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 20  .no column list 
3fa0: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 6f 72  is specified, or
3fb0: 20 69 74 20 6d 75 73 74 20 6d 61 74 63 68 20 74   it must match t
3fc0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c  he number of col
3fd0: 75 6d 6e 73 0a 6e 61 6d 65 20 69 6e 20 74 68 65  umns.name in the
3fe0: 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 2e 20 20 41   column list.  A
3ff0: 20 6e 65 77 20 65 6e 74 72 79 20 69 73 20 6d 61   new entry is ma
4000: 64 65 20 69 6e 20 74 68 65 20 74 61 62 6c 65 0a  de in the table.
4010: 66 6f 72 20 65 76 65 72 79 20 72 6f 77 20 6f 66  for every row of
4020: 20 74 68 65 20 53 45 4c 45 43 54 20 72 65 73 75   the SELECT resu
4030: 6c 74 2e 20 20 54 68 65 20 53 45 4c 45 43 54 20  lt.  The SELECT 
4040: 6d 61 79 20 62 65 20 73 69 6d 70 6c 65 0a 6f 72  may be simple.or
4050: 20 63 6f 6d 70 6f 75 6e 64 2e 20 20 49 66 20 74   compound.  If t
4060: 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d  he SELECT statem
4070: 65 6e 74 20 68 61 73 20 61 6e 20 4f 52 44 45 52  ent has an ORDER
4080: 20 42 59 20 63 6c 61 75 73 65 2c 0a 74 68 65 20   BY clause,.the 
4090: 4f 52 44 45 52 20 42 59 20 69 73 20 69 67 6e 6f  ORDER BY is igno
40a0: 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74  red.</p>.}..Sect
40b0: 69 6f 6e 20 53 45 4c 45 43 54 20 73 65 6c 65 63  ion SELECT selec
40c0: 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  t..Syntax {sql-s
40d0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 53 45 4c 45  tatement} {.SELE
40e0: 43 54 20 3c 72 65 73 75 6c 74 3e 20 46 52 4f 4d  CT <result> FROM
40f0: 20 3c 74 61 62 6c 65 2d 6c 69 73 74 3e 20 0a 5b   <table-list> .[
4100: 57 48 45 52 45 20 3c 65 78 70 72 65 73 73 69 6f  WHERE <expressio
4110: 6e 3e 5d 0a 5b 47 52 4f 55 50 20 42 59 20 3c 65  n>].[GROUP BY <e
4120: 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b 48 41 56 49  xpr-list>].[HAVI
4130: 4e 47 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d  NG <expression>]
4140: 0a 5b 3c 63 6f 6d 70 6f 75 6e 64 2d 6f 70 3e 20  .[<compound-op> 
4150: 3c 73 65 6c 65 63 74 3e 5d 2a 0a 5b 4f 52 44 45  <select>]*.[ORDE
4160: 52 20 42 59 20 3c 73 6f 72 74 2d 65 78 70 72 2d  R BY <sort-expr-
4170: 6c 69 73 74 3e 5d 0a 7d 20 7b 72 65 73 75 6c 74  list>].} {result
4180: 7d 20 7b 0a 53 54 41 52 20 7c 20 3c 72 65 73 75  } {.STAR | <resu
4190: 6c 74 2d 63 6f 6c 75 6d 6e 3e 20 5b 2c 20 3c 72  lt-column> [, <r
41a0: 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 5d 2a 0a  esult-column>]*.
41b0: 7d 20 7b 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e  } {result-column
41c0: 7d 20 7b 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e  } {.<expression>
41d0: 20 5b 20 5b 41 53 5d 20 3c 73 74 72 69 6e 67 3e   [ [AS] <string>
41e0: 20 5d 0a 7d 20 7b 74 61 62 6c 65 2d 6c 69 73 74   ].} {table-list
41f0: 7d 20 7b 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  } {.<table-name>
4200: 20 5b 2c 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e   [, <table-name>
4210: 5d 2a 0a 7d 20 7b 73 6f 72 74 2d 65 78 70 72 2d  ]*.} {sort-expr-
4220: 6c 69 73 74 7d 20 7b 0a 3c 65 78 70 72 3e 20 5b  list} {.<expr> [
4230: 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20 5b 2c  <sort-order>] [,
4240: 20 3c 65 78 70 72 3e 20 5b 3c 73 6f 72 74 2d 6f   <expr> [<sort-o
4250: 72 64 65 72 3e 5d 5d 2a 0a 7d 20 7b 73 6f 72 74  rder>]]*.} {sort
4260: 2d 6f 72 64 65 72 7d 20 7b 0a 41 53 43 20 7c 20  -order} {.ASC | 
4270: 44 45 53 43 0a 7d 20 7b 63 6f 6d 70 6f 75 6e 64  DESC.} {compound
4280: 5f 6f 70 7d 20 7b 0a 55 4e 49 4f 4e 20 7c 20 55  _op} {.UNION | U
4290: 4e 49 4f 4e 20 41 4c 4c 20 7c 20 49 4e 54 45 52  NION ALL | INTER
42a0: 53 45 43 54 20 7c 20 45 58 43 45 50 54 0a 7d 0a  SECT | EXCEPT.}.
42b0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 53  .puts {.<p>The S
42c0: 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20  ELECT statement 
42d0: 69 73 20 75 73 65 64 20 74 6f 20 71 75 65 72 79  is used to query
42e0: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20   the database.  
42f0: 54 68 65 0a 72 65 73 75 6c 74 20 6f 66 20 61 20  The.result of a 
4300: 53 45 4c 45 43 54 20 69 73 20 7a 65 72 6f 20 6f  SELECT is zero o
4310: 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66 20 64  r more rows of d
4320: 61 74 61 20 77 68 65 72 65 20 65 61 63 68 20 72  ata where each r
4330: 6f 77 0a 68 61 73 20 61 20 66 69 78 65 64 20 6e  ow.has a fixed n
4340: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
4350: 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  .  The number of
4360: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 0a   columns in the.
4370: 72 65 73 75 6c 74 20 69 73 20 73 70 65 63 69 66  result is specif
4380: 69 65 64 20 62 79 20 74 68 65 20 65 78 70 72 65  ied by the expre
4390: 73 73 69 6f 6e 20 6c 69 73 74 20 69 6e 20 62 65  ssion list in be
43a0: 74 77 65 65 6e 20 74 68 65 0a 53 45 4c 45 43 54  tween the.SELECT
43b0: 20 61 6e 64 20 46 52 4f 4d 20 6b 65 79 77 6f 72   and FROM keywor
43c0: 64 73 2e 20 20 41 6e 79 20 61 72 62 69 74 72 61  ds.  Any arbitra
43d0: 72 79 20 65 78 70 72 65 73 73 69 6f 6e 20 63 61  ry expression ca
43e0: 6e 20 62 65 20 75 73 65 64 0a 61 73 20 61 20 72  n be used.as a r
43f0: 65 73 75 6c 74 2e 20 20 49 66 20 74 68 65 20 72  esult.  If the r
4400: 65 73 75 6c 74 20 73 70 65 63 69 66 69 63 61 74  esult specificat
4410: 69 6f 6e 20 69 73 20 6a 75 73 74 7d 0a 70 75 74  ion is just}.put
4420: 73 20 22 5b 4f 70 65 72 61 74 6f 72 20 2a 5d 20  s "[Operator *] 
4430: 74 68 65 6e 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73  then all columns
4440: 20 6f 66 20 61 6c 6c 20 74 61 62 6c 65 73 20 61   of all tables a
4450: 72 65 20 75 73 65 64 20 61 73 20 74 68 65 20 72  re used as the r
4460: 65 73 75 6c 74 2e 22 0a 70 75 74 73 20 7b 3c 2f  esult.".puts {</
4470: 70 3e 0a 0a 3c 70 3e 54 68 65 20 71 75 65 72 79  p>..<p>The query
4480: 20 69 73 20 65 78 65 63 75 74 65 64 20 61 67 61   is executed aga
4490: 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 74  in one or more t
44a0: 61 62 6c 65 73 20 73 70 65 63 69 66 69 65 64 20  ables specified 
44b0: 61 66 74 65 72 0a 74 68 65 20 46 52 4f 4d 20 6b  after.the FROM k
44c0: 65 79 77 6f 72 64 2e 20 20 49 66 20 6d 6f 72 65  eyword.  If more
44d0: 20 74 68 61 6e 20 6f 6e 65 20 74 61 62 6c 65 20   than one table 
44e0: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 74 68  is specified, th
44f0: 65 6e 20 74 68 65 0a 71 75 65 72 79 20 69 73 20  en the.query is 
4500: 61 67 61 69 6e 73 74 20 74 68 65 20 6a 6f 69 6e  against the join
4510: 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20   of the various 
4520: 74 61 62 6c 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e  tables.</p>..<p>
4530: 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65  The WHERE clause
4540: 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20   can be used to 
4550: 6c 69 6d 69 74 20 74 68 65 20 6e 75 6d 62 65 72  limit the number
4560: 20 6f 66 20 72 6f 77 73 20 6f 76 65 72 0a 77 68   of rows over.wh
4570: 69 63 68 20 74 68 65 20 71 75 65 72 79 20 6f 70  ich the query op
4580: 65 72 61 74 65 73 2e 20 20 49 6e 20 74 68 65 20  erates.  In the 
4590: 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e  current implemen
45a0: 74 61 74 69 6f 6e 2c 0a 69 6e 64 69 63 65 73 20  tation,.indices 
45b0: 77 69 6c 6c 20 6f 6e 6c 79 20 62 65 20 75 73 65  will only be use
45c0: 64 20 74 6f 0a 6f 70 74 69 6d 69 7a 65 20 74 68  d to.optimize th
45d0: 65 20 71 75 65 72 79 20 69 66 20 57 48 45 52 45  e query if WHERE
45e0: 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 6e 74   expression cont
45f0: 61 69 6e 73 20 65 71 75 61 6c 69 74 79 20 63 6f  ains equality co
4600: 6d 70 61 72 69 73 6f 6e 73 0a 63 6f 6e 6e 65 63  mparisons.connec
4610: 74 65 64 20 62 79 20 74 68 65 20 41 4e 44 20 6f  ted by the AND o
4620: 70 65 72 61 74 6f 72 2e 3c 2f 70 3e 0a 0a 3c 70  perator.</p>..<p
4630: 3e 54 68 65 20 47 52 4f 55 50 20 42 59 20 63 6c  >The GROUP BY cl
4640: 61 75 73 65 73 20 63 61 75 73 65 73 20 6f 6e 65  auses causes one
4650: 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66   or more rows of
4660: 20 74 68 65 20 72 65 73 75 6c 74 20 74 6f 0a 62   the result to.b
4670: 65 20 63 6f 6d 62 69 6e 65 64 20 69 6e 74 6f 20  e combined into 
4680: 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f 66 20  a single row of 
4690: 6f 75 74 70 75 74 2e 20 20 54 68 69 73 20 69 73  output.  This is
46a0: 20 65 73 70 65 63 69 61 6c 6c 79 20 75 73 65 66   especially usef
46b0: 75 6c 0a 77 68 65 6e 20 74 68 65 20 72 65 73 75  ul.when the resu
46c0: 6c 74 20 63 6f 6e 74 61 69 6e 73 20 61 67 67 72  lt contains aggr
46d0: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e  egate functions.
46e0: 20 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e    The expression
46f0: 73 20 69 6e 0a 74 68 65 20 47 52 4f 55 50 20 42  s in.the GROUP B
4700: 59 20 63 6c 61 75 73 65 20 64 6f 20 3c 65 6d 3e  Y clause do <em>
4710: 6e 6f 74 3c 2f 65 6d 3e 20 68 61 76 65 20 74 6f  not</em> have to
4720: 20 62 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20   be expressions 
4730: 74 68 61 74 0a 61 70 70 65 61 72 20 69 6e 20 74  that.appear in t
4740: 68 65 20 72 65 73 75 6c 74 2e 20 20 54 68 65 20  he result.  The 
4750: 48 41 56 49 4e 47 20 63 6c 61 75 73 65 20 69 73  HAVING clause is
4760: 20 73 69 6d 69 6c 61 72 20 74 6f 20 57 48 45 52   similar to WHER
4770: 45 20 65 78 63 65 70 74 0a 74 68 61 74 20 48 41  E except.that HA
4780: 56 49 4e 47 20 61 70 70 6c 69 65 73 20 61 66 74  VING applies aft
4790: 65 72 20 67 72 6f 75 70 69 6e 67 20 68 61 73 20  er grouping has 
47a0: 6f 63 63 75 72 72 65 64 2e 20 20 54 68 65 20 48  occurred.  The H
47b0: 41 56 49 4e 47 20 65 78 70 72 65 73 73 69 6f 6e  AVING expression
47c0: 0a 6d 61 79 20 72 65 66 65 72 20 74 6f 20 76 61  .may refer to va
47d0: 6c 75 65 73 2c 20 65 76 65 6e 20 61 67 67 72 65  lues, even aggre
47e0: 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20  gate functions, 
47f0: 74 68 61 74 20 61 72 65 20 6e 6f 74 20 69 6e 20  that are not in 
4800: 74 68 65 20 72 65 73 75 6c 74 2e 3c 2f 70 3e 0a  the result.</p>.
4810: 0a 3c 70 3e 54 68 65 20 4f 52 44 45 52 20 42 59  .<p>The ORDER BY
4820: 20 63 6c 61 75 73 65 20 63 61 75 73 65 73 20 74   clause causes t
4830: 68 65 20 6f 75 74 70 75 74 20 72 6f 77 73 20 74  he output rows t
4840: 6f 20 62 65 20 73 6f 72 74 65 64 2e 20 20 0a 54  o be sorted.  .T
4850: 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 4f  he argument to O
4860: 52 44 45 52 20 42 59 20 69 73 20 61 20 6c 69 73  RDER BY is a lis
4870: 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e 73  t of expressions
4880: 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 61   that are used a
4890: 73 20 74 68 65 0a 6b 65 79 20 66 6f 72 20 74 68  s the.key for th
48a0: 65 20 73 6f 72 74 2e 20 20 54 68 65 20 65 78 70  e sort.  The exp
48b0: 72 65 73 73 69 6f 6e 73 20 64 6f 20 6e 6f 74 20  ressions do not 
48c0: 68 61 76 65 20 74 6f 20 62 65 20 70 61 72 74 20  have to be part 
48d0: 6f 66 20 74 68 65 0a 72 65 73 75 6c 74 20 66 6f  of the.result fo
48e0: 72 20 61 20 73 69 6d 70 6c 65 20 53 45 4c 45 43  r a simple SELEC
48f0: 54 2c 20 62 75 74 20 69 6e 20 61 20 63 6f 6d 70  T, but in a comp
4900: 6f 75 6e 64 20 53 45 4c 45 43 54 20 65 61 63 68  ound SELECT each
4910: 20 73 6f 72 74 0a 65 78 70 72 65 73 73 69 6f 6e   sort.expression
4920: 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61   must exactly ma
4930: 74 63 68 20 6f 6e 65 20 6f 66 20 74 68 65 20 72  tch one of the r
4940: 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20 20  esult columns.  
4950: 45 61 63 68 0a 73 6f 72 74 20 65 78 70 72 65 73  Each.sort expres
4960: 73 69 6f 6e 20 6d 61 79 20 62 65 20 6f 70 74 69  sion may be opti
4970: 6f 6e 61 6c 6c 79 20 66 6f 6c 6c 6f 77 65 64 20  onally followed 
4980: 62 79 20 41 53 43 20 6f 72 20 44 45 53 43 20 74  by ASC or DESC t
4990: 6f 20 73 70 65 63 69 66 79 0a 74 68 65 20 73 6f  o specify.the so
49a0: 72 74 20 6f 72 64 65 72 2e 3c 2f 70 3e 0a 0a 3c  rt order.</p>..<
49b0: 70 3e 41 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c  p>A compound SEL
49c0: 45 43 54 20 69 73 20 66 6f 72 6d 65 64 20 66 72  ECT is formed fr
49d0: 6f 6d 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 73  om two or more s
49e0: 69 6d 70 6c 65 20 53 45 4c 45 43 54 73 20 63 6f  imple SELECTs co
49f0: 6e 6e 65 63 74 65 64 0a 62 79 20 6f 6e 65 20 6f  nnected.by one o
4a00: 66 20 74 68 65 20 6f 70 65 72 61 74 6f 72 73 20  f the operators 
4a10: 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c  UNION, UNION ALL
4a20: 2c 20 49 4e 54 45 52 53 45 43 54 2c 20 6f 72 20  , INTERSECT, or 
4a30: 45 58 43 45 50 54 2e 20 20 49 6e 0a 61 20 63 6f  EXCEPT.  In.a co
4a40: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2c 20 61  mpound SELECT, a
4a50: 6c 6c 20 74 68 65 20 63 6f 6e 73 74 69 74 75 65  ll the constitue
4a60: 6e 74 20 53 45 4c 45 43 54 73 20 6d 75 73 74 20  nt SELECTs must 
4a70: 73 70 65 63 69 66 79 20 74 68 65 0a 73 61 6d 65  specify the.same
4a80: 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c   number of resul
4a90: 74 20 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 72  t columns.  Ther
4aa0: 65 20 6d 61 79 20 62 65 20 6f 6e 6c 79 20 61 20  e may be only a 
4ab0: 73 69 6e 67 6c 65 20 4f 52 44 45 52 20 42 59 0a  single ORDER BY.
4ac0: 63 6c 61 75 73 65 20 61 74 20 74 68 65 20 65 6e  clause at the en
4ad0: 64 20 6f 66 20 74 68 65 20 63 6f 6d 70 6f 75 6e  d of the compoun
4ae0: 64 20 53 45 4c 45 43 54 2e 20 20 54 68 65 20 55  d SELECT.  The U
4af0: 4e 49 4f 4e 20 61 6e 64 20 55 4e 49 4f 4e 20 41  NION and UNION A
4b00: 4c 4c 0a 6f 70 65 72 61 74 6f 72 73 20 63 6f 6d  LL.operators com
4b10: 62 69 6e 65 20 74 68 65 20 72 65 73 75 6c 74 73  bine the results
4b20: 20 6f 66 20 74 68 65 20 53 45 4c 45 43 54 73 20   of the SELECTs 
4b30: 74 6f 20 74 68 65 20 72 69 67 68 74 20 61 6e 64  to the right and
4b40: 20 6c 65 66 74 20 69 6e 74 6f 0a 61 20 73 69 6e   left into.a sin
4b50: 67 6c 65 20 62 69 67 20 74 61 62 6c 65 2e 20 20  gle big table.  
4b60: 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 69  The difference i
4b70: 73 20 74 68 61 74 20 69 6e 20 55 4e 49 4f 4e 20  s that in UNION 
4b80: 61 6c 6c 20 72 65 73 75 6c 74 20 72 6f 77 73 0a  all result rows.
4b90: 61 72 65 20 64 69 73 74 69 6e 63 74 20 77 68 65  are distinct whe
4ba0: 72 65 20 69 6e 20 55 4e 49 4f 4e 20 41 4c 4c 20  re in UNION ALL 
4bb0: 74 68 65 72 65 20 6d 61 79 20 62 65 20 64 75 70  there may be dup
4bc0: 6c 69 63 61 74 65 73 2e 0a 54 68 65 20 49 4e 54  licates..The INT
4bd0: 45 52 53 45 43 54 20 6f 70 65 72 61 74 6f 72 20  ERSECT operator 
4be0: 74 61 6b 65 73 20 74 68 65 20 69 6e 74 65 72 73  takes the inters
4bf0: 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 72 65  ection of the re
4c00: 73 75 6c 74 73 20 6f 66 20 74 68 65 0a 6c 65 66  sults of the.lef
4c10: 74 20 61 6e 64 20 72 69 67 68 74 20 53 45 4c 45  t and right SELE
4c20: 43 54 73 2e 20 20 45 58 43 45 50 54 20 74 61 6b  CTs.  EXCEPT tak
4c30: 65 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  es the result of
4c40: 20 6c 65 66 74 20 53 45 4c 45 43 54 20 61 66 74   left SELECT aft
4c50: 65 72 0a 72 65 6d 6f 76 69 6e 67 20 74 68 65 20  er.removing the 
4c60: 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 72  results of the r
4c70: 69 67 68 74 20 53 45 4c 45 43 54 2e 20 20 57 68  ight SELECT.  Wh
4c80: 65 6e 20 74 68 72 65 65 20 61 72 65 20 6d 6f 72  en three are mor
4c90: 65 20 53 45 4c 45 43 54 73 0a 61 72 65 20 63 6f  e SELECTs.are co
4ca0: 6e 6e 65 63 74 65 64 20 69 6e 74 6f 20 61 20 63  nnected into a c
4cb0: 6f 6d 70 6f 75 6e 64 2c 20 74 68 65 79 20 67 72  ompound, they gr
4cc0: 6f 75 70 20 66 72 6f 6d 20 6c 65 66 74 20 74 6f  oup from left to
4cd0: 20 72 69 67 68 74 2e 3c 2f 70 3e 0a 7d 0a 0a 53   right.</p>.}..S
4ce0: 65 63 74 69 6f 6e 20 55 50 44 41 54 45 20 75 70  ection UPDATE up
4cf0: 64 61 74 65 0a 0a 53 79 6e 74 61 78 20 7b 73 71  date..Syntax {sq
4d00: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 55  l-statement} {.U
4d10: 50 44 41 54 45 20 3c 74 61 62 6c 65 2d 6e 61 6d  PDATE <table-nam
4d20: 65 3e 20 53 45 54 20 3c 61 73 73 69 67 6e 6d 65  e> SET <assignme
4d30: 6e 74 3e 20 5b 2c 20 3c 61 73 73 69 67 6e 6d 65  nt> [, <assignme
4d40: 6e 74 3e 5d 20 5b 57 48 45 52 45 20 3c 65 78 70  nt>] [WHERE <exp
4d50: 72 65 73 73 69 6f 6e 3e 5d 0a 7d 20 7b 61 73 73  ression>].} {ass
4d60: 69 67 6e 6d 65 6e 74 7d 20 7b 0a 3c 63 6f 6c 75  ignment} {.<colu
4d70: 6d 6e 2d 6e 61 6d 65 3e 20 3d 20 3c 65 78 70 72  mn-name> = <expr
4d80: 65 73 73 69 6f 6e 3e 0a 7d 0a 0a 70 75 74 73 20  ession>.}..puts 
4d90: 7b 0a 3c 70 3e 54 68 65 20 55 50 44 41 54 45 20  {.<p>The UPDATE 
4da0: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 75 73 65  statement is use
4db0: 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20  d to change the 
4dc0: 76 61 6c 75 65 20 6f 66 20 63 6f 6c 75 6d 6e 73  value of columns
4dd0: 20 69 6e 20 0a 73 65 6c 65 63 74 65 64 20 72 6f   in .selected ro
4de0: 77 73 20 6f 66 20 61 20 74 61 62 6c 65 2e 20 20  ws of a table.  
4df0: 45 61 63 68 20 61 73 73 69 67 6e 6d 65 6e 74 20  Each assignment 
4e00: 69 6e 20 61 6e 20 55 50 44 41 54 45 20 73 70 65  in an UPDATE spe
4e10: 63 69 66 69 65 73 0a 61 20 63 6f 6c 75 6d 6e 20  cifies.a column 
4e20: 6e 61 6d 65 20 74 6f 20 74 68 65 20 6c 65 66 74  name to the left
4e30: 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73 20 73   of the equals s
4e40: 69 67 6e 20 61 6e 64 20 61 6e 20 61 72 62 69 74  ign and an arbit
4e50: 72 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e 0a  rary expression.
4e60: 74 6f 20 74 68 65 20 72 69 67 68 74 2e 20 20 54  to the right.  T
4e70: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 6d  he expressions m
4e80: 61 79 20 75 73 65 20 74 68 65 20 76 61 6c 75 65  ay use the value
4e90: 73 20 6f 66 20 6f 74 68 65 72 20 63 6f 6c 75 6d  s of other colum
4ea0: 6e 73 2e 0a 41 6c 6c 20 65 78 70 72 65 73 73 69  ns..All expressi
4eb0: 6f 6e 73 20 61 72 65 20 65 76 61 6c 75 61 74 65  ons are evaluate
4ec0: 64 20 62 65 66 6f 72 65 20 61 6e 79 20 61 73 73  d before any ass
4ed0: 69 67 6e 6d 65 6e 74 73 20 61 72 65 20 6d 61 64  ignments are mad
4ee0: 65 2e 0a 41 20 57 48 45 52 45 20 63 6c 61 75 73  e..A WHERE claus
4ef0: 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  e can be used to
4f00: 20 72 65 73 74 72 69 63 74 20 77 68 69 63 68 20   restrict which 
4f10: 72 6f 77 73 20 61 72 65 20 75 70 64 61 74 65 64  rows are updated
4f20: 2e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 56 41 43  ..}..Section VAC
4f30: 55 55 4d 20 76 61 63 75 75 6d 0a 0a 53 79 6e 74  UUM vacuum..Synt
4f40: 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e  ax {sql-statemen
4f50: 74 7d 20 7b 0a 56 41 43 55 55 4d 20 5b 3c 69 6e  t} {.VACUUM [<in
4f60: 64 65 78 2d 6f 72 2d 74 61 62 6c 65 2d 6e 61 6d  dex-or-table-nam
4f70: 65 3e 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  e>].}..puts {.<p
4f80: 3e 54 68 65 20 56 41 43 55 55 4d 20 63 6f 6d 6d  >The VACUUM comm
4f90: 61 6e 64 20 69 73 20 61 6e 20 53 51 4c 69 74 65  and is an SQLite
4fa0: 20 65 78 74 65 6e 73 69 6f 6e 20 6d 6f 64 65 6c   extension model
4fb0: 6c 65 64 20 61 66 74 65 72 20 61 20 73 69 6d 69  led after a simi
4fc0: 6c 61 72 0a 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e  lar.command foun
4fd0: 64 20 69 6e 20 50 6f 73 74 67 72 65 53 51 4c 2e  d in PostgreSQL.
4fe0: 20 20 49 66 20 56 41 43 55 55 4d 20 69 73 20 69    If VACUUM is i
4ff0: 6e 76 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20  nvoked with the 
5000: 6e 61 6d 65 20 6f 66 20 61 0a 74 61 62 6c 65 20  name of a.table 
5010: 6f 72 20 69 6e 64 65 78 20 74 68 65 6e 20 69 74  or index then it
5020: 20 69 73 20 73 75 70 70 6f 73 65 20 74 6f 20 63   is suppose to c
5030: 6c 65 61 6e 20 75 70 20 74 68 65 20 6e 61 6d 65  lean up the name
5040: 64 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  d table or index
5050: 2e 0a 49 6e 20 74 68 65 20 63 75 72 72 65 6e 74  ..In the current
5060: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c   implementation,
5070: 20 56 41 43 55 55 4d 20 69 73 20 61 20 6e 6f 2d   VACUUM is a no-
5080: 6f 70 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74  op..</p>.}..Sect
5090: 69 6f 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d  ion PRAGMA pragm
50a0: 61 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  a..Syntax {sql-s
50b0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47  tatement} {.PRAG
50c0: 4d 41 20 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c  MA <name> = <val
50d0: 75 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  ue>.}..puts {.<p
50e0: 3e 54 68 65 20 50 52 41 47 4d 41 20 63 6f 6d 6d  >The PRAGMA comm
50f0: 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 6d  and is used to m
5100: 6f 64 69 66 79 20 74 68 65 20 6f 70 65 72 61 74  odify the operat
5110: 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c 69 74  ion of the SQLit
5120: 65 20 6c 69 62 72 61 72 79 2e 0a 41 64 64 69 74  e library..Addit
5130: 69 6f 6e 61 6c 20 64 6f 63 75 6d 65 6e 74 61 74  ional documentat
5140: 69 6f 6e 20 6f 6e 20 74 68 65 20 50 52 41 4d 47  ion on the PRAMG
5150: 41 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 66  A statement is f
5160: 6f 72 74 68 63 6f 6d 69 6e 67 2e 0a 3c 2f 70 3e  orthcoming..</p>
5170: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 3c 2f  .}..puts {.<p></
5180: 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  p>.}..puts {.<p>
5190: 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 3c 61  <hr /></p>.<p><a
51a0: 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d   href="index.htm
51b0: 6c 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67 6f  l"><img src="/go
51c0: 62 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65 72  back.jpg" border
51d0: 3d 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74 68  =0 />.Back to th
51e0: 65 20 53 51 4c 69 74 65 20 48 6f 6d 65 20 50 61  e SQLite Home Pa
51f0: 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 62  ge</a>.</p>..</b
5200: 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a           ody></html>}.