/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 3a7900e3f80cab50f322d925e573bd9f0acd57e1:


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 31 20 32 30 30 31  .tcl,v 1.11 2001
0060: 2f 31 30 2f 30 38 20 31 33 3a 32 32 3a 33 33 20  /10/08 13:22:33 
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 54 72 61 6e 73 61 63 74 69 6f 6e 73  d.  Transactions
0d70: 20 6d 61 79 20 6e 6f 74 20 62 65 20 6e 65 73 74   may not be nest
0d80: 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4e 6f  ed..</p>..<p>.No
0d90: 20 63 68 61 6e 67 65 73 20 63 61 6e 20 62 65 20   changes can be 
0da0: 6d 61 64 65 20 74 6f 20 74 68 65 20 64 61 74 61  made to the data
0db0: 62 61 73 65 20 65 78 63 65 70 74 20 77 69 74 68  base except with
0dc0: 69 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e  in a transaction
0dd0: 2e 0a 41 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68  ..Any command th
0de0: 61 74 20 63 68 61 6e 67 65 73 20 74 68 65 20 64  at changes the d
0df0: 61 74 61 62 61 73 65 20 28 62 61 73 69 63 61 6c  atabase (basical
0e00: 6c 79 2c 20 61 6e 79 20 53 51 4c 20 63 6f 6d 6d  ly, any SQL comm
0e10: 61 6e 64 0a 6f 74 68 65 72 20 74 68 61 6e 20 53  and.other than S
0e20: 45 4c 45 43 54 29 20 77 69 6c 6c 20 61 75 74 6f  ELECT) will auto
0e30: 6d 61 74 69 63 61 6c 6c 79 20 73 74 61 72 74 73  matically starts
0e40: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
0e50: 66 0a 6f 6e 65 20 69 73 20 6e 6f 74 20 61 6c 72  f.one is not alr
0e60: 65 61 64 79 20 69 6e 20 65 66 66 65 63 74 2e 20  eady in effect. 
0e70: 20 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73   Automatically s
0e80: 74 61 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f  tared transactio
0e90: 6e 73 0a 61 72 65 20 63 6f 6d 6d 69 74 74 65 64  ns.are committed
0ea0: 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69   at the conclusi
0eb0: 6f 6e 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e  on of the comman
0ec0: 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 72 61  d..</p>..<p>.Tra
0ed0: 6e 73 61 63 74 69 6f 6e 73 20 63 61 6e 20 62 65  nsactions can be
0ee0: 20 73 74 61 72 74 65 64 20 6d 61 6e 75 61 6c 6c   started manuall
0ef0: 79 20 75 73 69 6e 67 20 74 68 65 20 42 45 47 49  y using the BEGI
0f00: 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 0a 63 6f  N TRANSACTION.co
0f10: 6d 6d 61 6e 64 2e 20 53 75 63 68 20 74 72 61 6e  mmand. Such tran
0f20: 73 61 63 74 69 6f 6e 73 20 70 65 72 73 69 73 74  sactions persist
0f30: 20 75 6e 74 69 6c 20 61 20 43 4f 4d 4d 49 54 20   until a COMMIT 
0f40: 6f 72 20 52 4f 4c 4c 42 41 43 4b 0a 6f 72 20 75  or ROLLBACK.or u
0f50: 6e 74 69 6c 20 61 6e 20 65 72 72 6f 72 20 6f 63  ntil an error oc
0f60: 63 75 72 73 20 6f 72 20 74 68 65 20 64 61 74 61  curs or the data
0f70: 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 2e 20  base is closed. 
0f80: 20 49 66 20 61 6e 0a 65 72 72 6f 72 20 69 73 20   If an.error is 
0f90: 65 6e 63 6f 75 6e 74 65 72 65 64 20 6f 72 20 74  encountered or t
0fa0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63  he database is c
0fb0: 6c 6f 73 65 64 2c 20 74 68 65 20 74 72 61 6e 73  losed, the trans
0fc0: 61 63 74 69 6f 6e 0a 69 73 20 61 75 74 6f 6d 61  action.is automa
0fd0: 74 69 63 61 6c 6c 79 20 72 6f 6c 6c 65 64 20 62  tically rolled b
0fe0: 61 63 6b 2e 20 20 54 68 65 20 45 4e 44 20 54 52  ack.  The END TR
0ff0: 41 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e  ANSACTION comman
1000: 64 20 69 73 0a 61 20 61 6c 69 61 73 20 66 6f 72  d is.a alias for
1010: 20 43 4f 4d 4d 49 54 2e 0a 3c 2f 70 3e 0a 7d 0a   COMMIT..</p>.}.
1020: 0a 53 65 63 74 69 6f 6e 20 43 4f 50 59 20 63 6f  .Section COPY co
1030: 70 79 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  py..Syntax {sql-
1040: 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 4f 50  statement} {.COP
1050: 59 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 46  Y <table-name> F
1060: 52 4f 4d 20 3c 66 69 6c 65 6e 61 6d 65 3e 0a 7d  ROM <filename>.}
1070: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
1080: 43 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73 20  COPY command is 
1090: 61 6e 20 65 78 74 65 6e 73 69 6f 6e 20 75 73 65  an extension use
10a0: 64 20 74 6f 20 6c 6f 61 64 20 6c 61 72 67 65 20  d to load large 
10b0: 61 6d 6f 75 6e 74 73 20 6f 66 0a 64 61 74 61 20  amounts of.data 
10c0: 69 6e 74 6f 20 61 20 74 61 62 6c 65 2e 20 20 49  into a table.  I
10d0: 74 20 69 73 20 6d 6f 64 65 6c 65 64 20 61 66 74  t is modeled aft
10e0: 65 72 20 61 20 73 69 6d 69 6c 61 72 20 63 6f 6d  er a similar com
10f0: 6d 61 6e 64 20 66 6f 75 6e 64 0a 69 6e 20 50 6f  mand found.in Po
1100: 73 74 67 72 65 53 51 4c 2e 20 20 49 6e 20 66 61  stgreSQL.  In fa
1110: 63 74 2c 20 74 68 65 20 53 51 4c 69 74 65 20 43  ct, the SQLite C
1120: 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73 20 73  OPY command is s
1130: 70 65 63 69 66 69 63 61 6c 6c 79 0a 64 65 73 69  pecifically.desi
1140: 67 6e 65 64 20 74 6f 20 62 65 20 61 62 6c 65 20  gned to be able 
1150: 74 6f 20 72 65 61 64 20 74 68 65 20 6f 75 74 70  to read the outp
1160: 75 74 20 6f 66 20 74 68 65 20 50 6f 73 74 67 72  ut of the Postgr
1170: 65 53 51 4c 20 64 75 6d 70 0a 75 74 69 6c 69 74  eSQL dump.utilit
1180: 79 20 3c 62 3e 70 67 5f 64 75 6d 70 3c 2f 62 3e  y <b>pg_dump</b>
1190: 20 73 6f 20 74 68 61 74 20 64 61 74 61 20 63 61   so that data ca
11a0: 6e 20 62 65 20 65 61 73 69 6c 79 20 74 72 61 6e  n be easily tran
11b0: 73 66 65 72 72 65 64 20 66 72 6f 6d 0a 50 6f 73  sferred from.Pos
11c0: 74 67 72 65 53 51 4c 20 69 6e 74 6f 20 53 51 4c  tgreSQL into SQL
11d0: 69 74 65 2e 3c 70 3e 0a 0a 3c 70 3e 54 68 65 20  ite.<p>..<p>The 
11e0: 74 61 62 6c 65 2d 6e 61 6d 65 20 69 73 20 74 68  table-name is th
11f0: 65 20 6e 61 6d 65 20 6f 66 20 61 6e 20 65 78 69  e name of an exi
1200: 73 74 69 6e 67 20 74 61 62 6c 65 20 77 68 69 63  sting table whic
1210: 68 20 69 73 20 74 6f 0a 62 65 20 66 69 6c 6c 65  h is to.be fille
1220: 64 20 77 69 74 68 20 64 61 74 61 2e 20 20 54 68  d with data.  Th
1230: 65 20 66 69 6c 65 6e 61 6d 65 20 69 73 20 61 20  e filename is a 
1240: 73 74 72 69 6e 67 20 6f 72 20 69 64 65 6e 74 69  string or identi
1250: 66 69 65 72 20 74 68 61 74 0a 6e 61 6d 65 73 20  fier that.names 
1260: 61 20 66 69 6c 65 20 66 72 6f 6d 20 77 68 69 63  a file from whic
1270: 68 20 64 61 74 61 20 77 69 6c 6c 20 62 65 20 72  h data will be r
1280: 65 61 64 2e 20 20 54 68 65 20 66 69 6c 65 6e 61  ead.  The filena
1290: 6d 65 20 63 61 6e 20 62 65 0a 74 68 65 20 3c 62  me can be.the <b
12a0: 3e 53 54 44 49 4e 3c 2f 62 3e 20 74 6f 20 72 65  >STDIN</b> to re
12b0: 61 64 20 64 61 74 61 20 66 72 6f 6d 20 73 74 61  ad data from sta
12c0: 6e 64 61 72 64 20 69 6e 70 75 74 2e 3c 70 3e 0a  ndard input.<p>.
12d0: 0a 3c 70 3e 45 61 63 68 20 6c 69 6e 65 20 6f 66  .<p>Each line of
12e0: 20 74 68 65 20 69 6e 70 75 74 20 66 69 6c 65 20   the input file 
12f0: 69 73 20 63 6f 6e 76 65 72 74 65 64 20 69 6e 74  is converted int
1300: 6f 20 61 20 73 69 6e 67 6c 65 20 72 65 63 6f 72  o a single recor
1310: 64 0a 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20  d.in the table. 
1320: 20 43 6f 6c 75 6d 6e 73 20 61 72 65 20 73 65 70   Columns are sep
1330: 61 72 61 74 65 64 20 62 79 20 74 61 62 73 2e 20  arated by tabs. 
1340: 20 49 66 20 61 20 74 61 62 20 6f 63 63 75 72 73   If a tab occurs
1350: 20 61 73 0a 64 61 74 61 20 77 69 74 68 69 6e 20   as.data within 
1360: 61 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20 74  a column, then t
1370: 68 61 74 20 74 61 62 20 69 73 20 70 72 65 63 65  hat tab is prece
1380: 64 65 64 20 62 79 20 61 20 62 61 73 6b 73 6c 61  ded by a basksla
1390: 73 68 20 22 5c 22 0a 63 68 61 72 61 63 74 65 72  sh "\".character
13a0: 2e 20 20 41 20 62 61 73 6b 73 6c 61 73 68 20 69  .  A baskslash i
13b0: 6e 20 74 68 65 20 64 61 74 61 20 61 70 70 65 61  n the data appea
13c0: 72 73 20 61 73 20 74 77 6f 20 62 61 63 6b 73 6c  rs as two backsl
13d0: 61 73 68 65 73 20 69 6e 0a 61 20 72 6f 77 2e 3c  ashes in.a row.<
13e0: 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 74 68 65  /p>..<p>When the
13f0: 20 69 6e 70 75 74 20 64 61 74 61 20 73 6f 75 72   input data sour
1400: 63 65 20 69 73 20 53 54 44 49 4e 2c 20 74 68 65  ce is STDIN, the
1410: 20 69 6e 70 75 74 20 63 61 6e 20 62 65 20 74 65   input can be te
1420: 72 6d 69 6e 61 74 65 64 0a 62 79 20 61 20 6c 69  rminated.by a li
1430: 6e 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73  ne that contains
1440: 20 6f 6e 6c 79 20 61 20 62 61 73 6b 73 6c 61 73   only a baskslas
1450: 68 20 61 6e 64 20 61 20 64 6f 74 3a 7d 0a 70 75  h and a dot:}.pu
1460: 74 73 20 22 5c 22 5b 4f 70 65 72 61 74 6f 72 20  ts "\"[Operator 
1470: 5c 5c 2e 5d 5c 22 2e 3c 2f 70 3e 22 0a 0a 53 65  \\.]\".</p>"..Se
1480: 63 74 69 6f 6e 20 7b 43 52 45 41 54 45 20 49 4e  ction {CREATE IN
1490: 44 45 58 7d 20 63 72 65 61 74 65 69 6e 64 65 78  DEX} createindex
14a0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
14b0: 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41 54  atement} {.CREAT
14c0: 45 20 5b 55 4e 49 51 55 45 5d 20 49 4e 44 45 58  E [UNIQUE] INDEX
14d0: 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 20 0a 4f   <index-name> .O
14e0: 4e 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28  N <table-name> (
14f0: 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 5b   <column-name> [
1500: 2c 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 5d  , <column-name>]
1510: 2a 20 29 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 6e 61  * ).} {column-na
1520: 6d 65 7d 20 7b 0a 3c 6e 61 6d 65 3e 20 5b 20 41  me} {.<name> [ A
1530: 53 43 20 7c 20 44 45 53 43 20 5d 0a 7d 0a 0a 70  SC | DESC ].}..p
1540: 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 43 52 45  uts {.<p>The CRE
1550: 41 54 45 20 49 4e 44 45 58 20 63 6f 6d 6d 61 6e  ATE INDEX comman
1560: 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74 68  d consists of th
1570: 65 20 6b 65 79 77 6f 72 64 73 20 22 43 52 45 41  e keywords "CREA
1580: 54 45 20 49 4e 44 45 58 22 20 66 6f 6c 6c 6f 77  TE INDEX" follow
1590: 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20 6f  ed.by the name o
15a0: 66 20 74 68 65 20 6e 65 77 20 69 6e 64 65 78 2c  f the new index,
15b0: 20 74 68 65 20 6b 65 79 77 6f 72 64 20 22 4f 4e   the keyword "ON
15c0: 22 2c 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61  ", the name of a
15d0: 20 70 72 65 76 69 6f 75 73 6c 79 0a 63 72 65 61   previously.crea
15e0: 74 65 64 20 74 61 62 6c 65 20 74 68 61 74 20 69  ted table that i
15f0: 73 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 2c  s to be indexed,
1600: 20 61 6e 64 20 61 20 70 61 72 65 6e 74 68 65 73   and a parenthes
1610: 69 7a 65 64 20 6c 69 73 74 20 6f 66 20 6e 61 6d  ized list of nam
1620: 65 73 20 6f 66 0a 63 6f 6c 75 6d 6e 73 20 69 6e  es of.columns in
1630: 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20   the table that 
1640: 61 72 65 20 75 73 65 64 20 66 6f 72 20 74 68 65  are used for the
1650: 20 69 6e 64 65 78 20 6b 65 79 2e 0a 45 61 63 68   index key..Each
1660: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61 6e   column name can
1670: 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20   be followed by 
1680: 6f 6e 65 20 6f 66 20 74 68 65 20 22 41 53 43 22  one of the "ASC"
1690: 20 6f 72 20 22 44 45 53 43 22 20 6b 65 79 77 6f   or "DESC" keywo
16a0: 72 64 73 0a 74 6f 20 69 6e 64 69 63 61 74 65 20  rds.to indicate 
16b0: 73 6f 72 74 20 6f 72 64 65 72 2c 20 62 75 74 20  sort order, but 
16c0: 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72 20 69  the sort order i
16d0: 73 20 69 67 6e 6f 72 65 64 20 69 6e 20 74 68 65  s ignored in the
16e0: 20 63 75 72 72 65 6e 74 0a 69 6d 70 6c 65 6d 65   current.impleme
16f0: 6e 74 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70  ntation.</p>..<p
1700: 3e 54 68 65 72 65 20 61 72 65 20 6e 6f 20 61 72  >There are no ar
1710: 62 69 74 72 61 72 79 20 6c 69 6d 69 74 73 20 6f  bitrary limits o
1720: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  n the number of 
1730: 69 6e 64 69 63 65 73 20 74 68 61 74 20 63 61 6e  indices that can
1740: 20 62 65 0a 61 74 74 61 63 68 65 64 20 74 6f 20   be.attached to 
1750: 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 2c 20  a single table, 
1760: 6e 6f 72 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65  nor on the numbe
1770: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20  r of columns in 
1780: 61 6e 20 69 6e 64 65 78 2e 3c 2f 70 3e 0a 0a 3c  an index.</p>..<
1790: 70 3e 49 66 20 74 68 65 20 55 4e 49 51 55 45 20  p>If the UNIQUE 
17a0: 6b 65 79 77 6f 72 64 20 61 70 70 65 61 72 73 20  keyword appears 
17b0: 62 65 74 77 65 65 6e 20 43 52 45 41 54 45 20 61  between CREATE a
17c0: 6e 64 20 49 4e 44 45 58 20 74 68 65 6e 20 64 75  nd INDEX then du
17d0: 70 6c 69 63 61 74 65 0a 69 6e 64 65 78 20 65 6e  plicate.index en
17e0: 74 72 69 65 73 20 61 72 65 20 6e 6f 74 20 61 6c  tries are not al
17f0: 6c 6f 77 65 64 2e 20 20 41 6e 79 20 61 74 74 65  lowed.  Any atte
1800: 6d 70 74 20 74 6f 20 69 6e 73 65 72 74 20 61 20  mpt to insert a 
1810: 64 75 70 6c 69 63 61 74 65 20 65 6e 74 72 79 0a  duplicate entry.
1820: 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61  will result in a
1830: 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 61 6e   rollback and an
1840: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 3c   error message.<
1850: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 65 78 61 63  /p>..<p>The exac
1860: 74 20 74 65 78 74 0a 6f 66 20 65 61 63 68 20 43  t text.of each C
1870: 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74  REATE INDEX stat
1880: 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 65 64 20  ement is stored 
1890: 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65  in the <b>sqlite
18a0: 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a 74 61 62 6c  _master</b>.tabl
18b0: 65 2e 20 20 45 76 65 72 79 74 69 6d 65 20 74 68  e.  Everytime th
18c0: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6f 70  e database is op
18d0: 65 6e 65 64 2c 20 61 6c 6c 20 43 52 45 41 54 45  ened, all CREATE
18e0: 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74   INDEX statement
18f0: 73 0a 61 72 65 20 72 65 61 64 20 66 72 6f 6d 20  s.are read from 
1900: 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61  the <b>sqlite_ma
1910: 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65 20 61  ster</b> table a
1920: 6e 64 20 75 73 65 64 20 74 6f 20 72 65 67 65 6e  nd used to regen
1930: 65 72 61 74 65 0a 53 51 4c 69 74 65 27 73 20 69  erate.SQLite's i
1940: 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e  nternal represen
1950: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 69 6e  tation of the in
1960: 64 65 78 20 6c 61 79 6f 75 74 2e 3c 2f 70 3e 0a  dex layout.</p>.
1970: 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 43 52 45  }...Section {CRE
1980: 41 54 45 20 54 41 42 4c 45 7d 20 7b 63 72 65 61  ATE TABLE} {crea
1990: 74 65 74 61 62 6c 65 7d 0a 0a 53 79 6e 74 61 78  tetable}..Syntax
19a0: 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20 7b   {sql-command} {
19b0: 0a 43 52 45 41 54 45 20 5b 54 45 4d 50 20 7c 20  .CREATE [TEMP | 
19c0: 54 45 4d 50 4f 52 41 52 59 5d 20 54 41 42 4c 45  TEMPORARY] TABLE
19d0: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28 0a   <table-name> (.
19e0: 20 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e 20 5b    <column-def> [
19f0: 2c 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e 5d 2a  , <column-def>]*
1a00: 0a 20 20 5b 2c 20 3c 63 6f 6e 73 74 72 61 69 6e  .  [, <constrain
1a10: 74 3e 5d 2a 0a 29 0a 7d 20 7b 63 6f 6c 75 6d 6e  t>]*.).} {column
1a20: 2d 64 65 66 7d 20 7b 0a 3c 6e 61 6d 65 3e 20 3c  -def} {.<name> <
1a30: 74 79 70 65 3e 20 5b 3c 63 6f 6c 75 6d 6e 2d 63  type> [<column-c
1a40: 6f 6e 73 74 72 61 69 6e 74 3e 5d 2a 0a 7d 20 7b  onstraint>]*.} {
1a50: 74 79 70 65 7d 20 7b 0a 3c 74 79 70 65 6e 61 6d  type} {.<typenam
1a60: 65 3e 20 7c 0a 3c 74 79 70 65 6e 61 6d 65 3e 20  e> |.<typename> 
1a70: 28 20 3c 6e 75 6d 62 65 72 3e 20 29 20 7c 0a 3c  ( <number> ) |.<
1a80: 74 79 70 65 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d  typename> ( <num
1a90: 62 65 72 3e 20 2c 20 3c 6e 75 6d 62 65 72 3e 20  ber> , <number> 
1aa0: 29 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 63 6f 6e 73  ).} {column-cons
1ab0: 74 72 61 69 6e 74 7d 20 7b 0a 4e 4f 54 20 4e 55  traint} {.NOT NU
1ac0: 4c 4c 20 7c 0a 50 52 49 4d 41 52 59 20 4b 45 59  LL |.PRIMARY KEY
1ad0: 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20   [<sort-order>] 
1ae0: 7c 0a 55 4e 49 51 55 45 20 7c 0a 43 48 45 43 4b  |.UNIQUE |.CHECK
1af0: 20 28 20 3c 65 78 70 72 3e 20 29 20 7c 0a 44 45   ( <expr> ) |.DE
1b00: 46 41 55 4c 54 20 3c 76 61 6c 75 65 3e 0a 7d 20  FAULT <value>.} 
1b10: 7b 63 6f 6e 73 74 72 61 69 6e 74 7d 20 7b 0a 50  {constraint} {.P
1b20: 52 49 4d 41 52 59 20 4b 45 59 20 28 20 3c 6e 61  RIMARY KEY ( <na
1b30: 6d 65 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d 2a 20  me> [, <name>]* 
1b40: 29 20 7c 0a 55 4e 49 51 55 45 20 28 20 3c 6e 61  ) |.UNIQUE ( <na
1b50: 6d 65 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d 2a 20  me> [, <name>]* 
1b60: 29 20 7c 0a 43 48 45 43 4b 20 28 20 3c 65 78 70  ) |.CHECK ( <exp
1b70: 72 3e 20 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  r> ).}..puts {.<
1b80: 70 3e 41 20 43 52 45 41 54 45 20 54 41 42 4c 45  p>A CREATE TABLE
1b90: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 62 61   statement is ba
1ba0: 73 69 63 61 6c 6c 79 20 74 68 65 20 6b 65 79 77  sically the keyw
1bb0: 6f 72 64 73 20 22 43 52 45 41 54 45 20 54 41 42  ords "CREATE TAB
1bc0: 4c 45 22 0a 66 6f 6c 6c 6f 77 65 64 20 62 79 20  LE".followed by 
1bd0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 6e 65  the name of a ne
1be0: 77 20 74 61 62 6c 65 20 61 6e 64 20 61 20 70 61  w table and a pa
1bf0: 72 65 6e 74 68 65 73 69 7a 65 64 20 6c 69 73 74  renthesized list
1c00: 20 6f 66 20 63 6f 6c 75 6d 6e 0a 64 65 66 69 6e   of column.defin
1c10: 69 74 69 6f 6e 73 20 61 6e 64 20 63 6f 6e 73 74  itions and const
1c20: 72 61 69 6e 74 73 2e 20 20 54 68 65 20 74 61 62  raints.  The tab
1c30: 6c 65 20 6e 61 6d 65 20 63 61 6e 20 62 65 20 65  le name can be e
1c40: 69 74 68 65 72 20 61 6e 20 69 64 65 6e 74 69 66  ither an identif
1c50: 69 65 72 0a 6f 72 20 61 20 73 74 72 69 6e 67 2e  ier.or a string.
1c60: 20 20 54 68 65 20 6f 6e 6c 79 20 72 65 73 65 72    The only reser
1c70: 76 65 64 20 74 61 62 6c 65 20 6e 61 6d 65 20 69  ved table name i
1c80: 73 20 22 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73  s "<b>sqlite_mas
1c90: 74 65 72 3c 2f 62 3e 22 20 77 68 69 63 68 0a 69  ter</b>" which.i
1ca0: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  s the name of th
1cb0: 65 20 74 61 62 6c 65 20 74 68 61 74 20 72 65 63  e table that rec
1cc0: 6f 72 64 73 20 74 68 65 20 64 61 74 61 62 61 73  ords the databas
1cd0: 65 20 73 63 68 65 6d 61 2e 3c 2f 70 3e 0a 0a 3c  e schema.</p>..<
1ce0: 70 3e 45 61 63 68 20 63 6f 6c 75 6d 6e 20 64 65  p>Each column de
1cf0: 66 69 6e 69 74 69 6f 6e 20 69 73 20 74 68 65 20  finition is the 
1d00: 6e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 75  name of the colu
1d10: 6d 6e 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74  mn followed by t
1d20: 68 65 0a 64 61 74 61 74 79 70 65 20 66 6f 72 20  he.datatype for 
1d30: 74 68 61 74 20 63 6f 6c 75 6d 6e 2c 20 74 68 65  that column, the
1d40: 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 70  n one or more op
1d50: 74 69 6f 6e 61 6c 20 63 6f 6c 75 6d 6e 20 63 6f  tional column co
1d60: 6e 73 74 72 61 69 6e 74 73 2e 0a 54 68 65 20 64  nstraints..The d
1d70: 61 74 61 74 79 70 65 20 66 6f 72 20 74 68 65 20  atatype for the 
1d80: 63 6f 6c 75 6d 6e 20 69 73 20 69 67 6e 6f 72 65  column is ignore
1d90: 64 2e 20 20 41 6c 6c 20 69 6e 66 6f 72 6d 61 74  d.  All informat
1da0: 69 6f 6e 0a 69 73 20 73 74 6f 72 65 64 20 61 73  ion.is stored as
1db0: 20 6e 75 6c 6c 2d 74 65 72 6d 69 6e 61 74 65 64   null-terminated
1dc0: 20 73 74 72 69 6e 67 73 2e 0a 54 68 65 20 55 4e   strings..The UN
1dd0: 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20  IQUE constraint 
1de0: 63 61 75 73 65 73 20 61 6e 20 69 6e 64 65 78 20  causes an index 
1df0: 74 6f 20 62 65 20 63 72 65 61 74 65 64 20 6f 6e  to be created on
1e00: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 0a 63   the specified.c
1e10: 6f 6c 75 6d 6e 73 2e 20 20 54 68 69 73 20 69 6e  olumns.  This in
1e20: 64 65 78 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e  dex must contain
1e30: 20 75 6e 69 71 75 65 20 6b 65 79 73 2e 20 20 54   unique keys.  T
1e40: 68 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63  he PRIMARY KEY c
1e50: 6f 6e 73 74 72 61 69 6e 74 0a 69 73 20 61 6e 20  onstraint.is an 
1e60: 61 6c 69 61 73 20 66 6f 72 20 55 4e 49 51 55 45  alias for UNIQUE
1e70: 2e 0a 54 68 65 20 44 45 46 41 55 4c 54 20 63 6f  ..The DEFAULT co
1e80: 6e 73 74 72 61 69 6e 74 0a 73 70 65 63 69 66 69  nstraint.specifi
1e90: 65 73 20 61 20 64 65 66 61 75 6c 74 20 76 61 6c  es a default val
1ea0: 75 65 20 74 6f 20 75 73 65 20 77 68 65 6e 20 64  ue to use when d
1eb0: 6f 69 6e 67 20 61 6e 20 49 4e 53 45 52 54 2e 0a  oing an INSERT..
1ec0: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20  </p>..<p>If the 
1ed0: 22 54 45 4d 50 22 20 6f 72 20 22 54 45 4d 50 4f  "TEMP" or "TEMPO
1ee0: 52 41 52 59 22 20 6b 65 79 77 6f 72 64 20 6f 63  RARY" keyword oc
1ef0: 63 75 72 73 20 69 6e 20 62 65 74 77 65 65 6e 20  curs in between 
1f00: 22 43 52 45 41 54 45 22 0a 61 6e 64 20 22 54 41  "CREATE".and "TA
1f10: 42 4c 45 22 20 74 68 65 6e 20 74 68 65 20 74 61  BLE" then the ta
1f20: 62 6c 65 20 74 68 61 74 20 69 73 20 63 72 65 61  ble that is crea
1f30: 74 65 64 20 69 73 20 6f 6e 6c 79 20 76 69 73 69  ted is only visi
1f40: 62 6c 65 20 74 6f 20 74 68 65 0a 70 72 6f 63 65  ble to the.proce
1f50: 73 73 20 74 68 61 74 20 6f 70 65 6e 65 64 20 74  ss that opened t
1f60: 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20  he database and 
1f70: 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  is automatically
1f80: 20 64 65 6c 65 74 65 64 20 77 68 65 6e 0a 74 68   deleted when.th
1f90: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c  e database is cl
1fa0: 6f 73 65 64 2e 20 20 41 6e 79 20 69 6e 64 69 63  osed.  Any indic
1fb0: 65 73 20 63 72 65 61 74 65 64 20 6f 6e 20 61 20  es created on a 
1fc0: 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 0a  temporary table.
1fd0: 61 72 65 20 61 6c 73 6f 20 74 65 6d 70 6f 72 61  are also tempora
1fe0: 72 79 2e 20 20 54 65 6d 70 6f 72 61 72 79 20 74  ry.  Temporary t
1ff0: 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65  ables and indice
2000: 73 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20  s are stored in 
2010: 61 0a 73 65 70 61 72 61 74 65 20 66 69 6c 65 20  a.separate file 
2020: 64 69 73 74 69 6e 63 74 20 66 72 6f 6d 20 74 68  distinct from th
2030: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20  e main database 
2040: 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  file.</p>..<p>Th
2050: 65 72 65 20 61 72 65 20 6e 6f 20 61 72 62 69 74  ere are no arbit
2060: 72 61 72 79 20 6c 69 6d 69 74 73 20 6f 6e 20 74  rary limits on t
2070: 68 65 20 6e 75 6d 62 65 72 0a 6f 66 20 63 6f 6c  he number.of col
2080: 75 6d 6e 73 20 6f 72 20 6f 6e 20 74 68 65 20 6e  umns or on the n
2090: 75 6d 62 65 72 20 6f 66 20 63 6f 6e 73 74 72 61  umber of constra
20a0: 69 6e 74 73 20 69 6e 20 61 20 74 61 62 6c 65 2e  ints in a table.
20b0: 0a 54 68 65 20 74 6f 74 61 6c 20 61 6d 6f 75 6e  .The total amoun
20c0: 74 20 6f 66 20 64 61 74 61 20 69 6e 20 61 20 73  t of data in a s
20d0: 69 6e 67 6c 65 20 72 6f 77 20 69 73 20 6c 69 6d  ingle row is lim
20e0: 69 74 65 64 20 74 6f 20 36 35 35 33 35 20 62 79  ited to 65535 by
20f0: 74 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  tes.</p>..<p>The
2100: 20 65 78 61 63 74 20 74 65 78 74 0a 6f 66 20 65   exact text.of e
2110: 61 63 68 20 43 52 45 41 54 45 20 54 41 42 4c 45  ach CREATE TABLE
2120: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73 74   statement is st
2130: 6f 72 65 64 20 69 6e 20 74 68 65 20 3c 62 3e 73  ored in the <b>s
2140: 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e  qlite_master</b>
2150: 0a 74 61 62 6c 65 2e 20 20 45 76 65 72 79 74 69  .table.  Everyti
2160: 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  me the database 
2170: 69 73 20 6f 70 65 6e 65 64 2c 20 61 6c 6c 20 43  is opened, all C
2180: 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61 74  REATE TABLE stat
2190: 65 6d 65 6e 74 73 0a 61 72 65 20 72 65 61 64 20  ements.are read 
21a0: 66 72 6f 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69  from the <b>sqli
21b0: 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61  te_master</b> ta
21c0: 62 6c 65 20 61 6e 64 20 75 73 65 64 20 74 6f 20  ble and used to 
21d0: 72 65 67 65 6e 65 72 61 74 65 0a 53 51 4c 69 74  regenerate.SQLit
21e0: 65 27 73 20 69 6e 74 65 72 6e 61 6c 20 72 65 70  e's internal rep
21f0: 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  resentation of t
2200: 68 65 20 74 61 62 6c 65 20 6c 61 79 6f 75 74 2e  he table layout.
2210: 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20  </p>.}..Section 
2220: 44 45 4c 45 54 45 20 64 65 6c 65 74 65 0a 0a 53  DELETE delete..S
2230: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
2240: 6d 65 6e 74 7d 20 7b 0a 44 45 4c 45 54 45 20 46  ment} {.DELETE F
2250: 52 4f 4d 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  ROM <table-name>
2260: 20 5b 57 48 45 52 45 20 3c 65 78 70 72 65 73 73   [WHERE <express
2270: 69 6f 6e 3e 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a  ion>].}..puts {.
2280: 3c 70 3e 54 68 65 20 44 45 4c 45 54 45 20 63 6f  <p>The DELETE co
2290: 6d 6d 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f  mmand is used to
22a0: 20 72 65 6d 6f 76 65 20 72 65 63 6f 72 64 73 20   remove records 
22b0: 66 72 6f 6d 20 61 20 74 61 62 6c 65 2e 0a 54 68  from a table..Th
22c0: 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73  e command consis
22d0: 74 73 20 6f 66 20 74 68 65 20 22 44 45 4c 45 54  ts of the "DELET
22e0: 45 20 46 52 4f 4d 22 20 6b 65 79 77 6f 72 64 73  E FROM" keywords
22f0: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 0a 74 68 65   followed by.the
2300: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
2310: 6c 65 20 66 72 6f 6d 20 77 68 69 63 68 20 72 65  le from which re
2320: 63 6f 72 64 73 20 61 72 65 20 74 6f 20 62 65 20  cords are to be 
2330: 72 65 6d 6f 76 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c  removed..</p>..<
2340: 70 3e 57 69 74 68 6f 75 74 20 61 20 57 48 45 52  p>Without a WHER
2350: 45 20 63 6c 61 75 73 65 2c 20 61 6c 6c 20 72 6f  E clause, all ro
2360: 77 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  ws of the table 
2370: 61 72 65 20 72 65 6d 6f 76 65 64 2e 0a 49 66 20  are removed..If 
2380: 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 69  a WHERE clause i
2390: 73 20 73 75 70 70 6c 69 65 64 2c 20 74 68 65 6e  s supplied, then
23a0: 20 6f 6e 6c 79 20 74 68 6f 73 65 20 72 6f 77 73   only those rows
23b0: 20 74 68 61 74 20 6d 61 74 63 68 0a 74 68 65 20   that match.the 
23c0: 65 78 70 72 65 73 73 69 6f 6e 20 61 72 65 20 72  expression are r
23d0: 65 6d 6f 76 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a  emoved.</p>.}...
23e0: 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20 49 4e  Section {DROP IN
23f0: 44 45 58 7d 20 64 72 6f 70 69 6e 64 65 78 0a 0a  DEX} dropindex..
2400: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d  Syntax {sql-comm
2410: 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 49 4e 44 45  and} {.DROP INDE
2420: 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 0a 7d  X <index-name>.}
2430: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
2440: 44 52 4f 50 20 49 4e 44 45 58 20 73 74 61 74 65  DROP INDEX state
2450: 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73 20 6f 66  ment consists of
2460: 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22 44   the keywords "D
2470: 52 4f 50 20 49 4e 44 45 58 22 20 66 6f 6c 6c 6f  ROP INDEX" follo
2480: 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20  wed.by the name 
2490: 6f 66 20 74 68 65 20 69 6e 64 65 78 2e 20 20 54  of the index.  T
24a0: 68 65 20 69 6e 64 65 78 20 6e 61 6d 65 64 20 69  he index named i
24b0: 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 72 65 6d  s completely rem
24c0: 6f 76 65 64 20 66 72 6f 6d 0a 74 68 65 20 64 69  oved from.the di
24d0: 73 6b 2e 20 20 54 68 65 20 6f 6e 6c 79 20 77 61  sk.  The only wa
24e0: 79 20 74 6f 20 72 65 63 6f 76 65 72 20 74 68 65  y to recover the
24f0: 20 69 6e 64 65 78 20 69 73 20 74 6f 20 72 65 65   index is to ree
2500: 6e 74 65 72 20 74 68 65 0a 61 70 70 72 6f 70 72  nter the.appropr
2510: 69 61 74 65 20 43 52 45 41 54 45 20 49 4e 44 45  iate CREATE INDE
2520: 58 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 7d  X command.</p>.}
2530: 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20  ..Section {DROP 
2540: 54 41 42 4c 45 7d 20 64 72 6f 70 74 61 62 6c 65  TABLE} droptable
2550: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f  ..Syntax {sql-co
2560: 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 54 41  mmand} {.DROP TA
2570: 42 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  BLE <table-name>
2580: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
2590: 65 20 44 52 4f 50 20 54 41 42 4c 45 20 73 74 61  e DROP TABLE sta
25a0: 74 65 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73 20  tement consists 
25b0: 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20  of the keywords 
25c0: 22 44 52 4f 50 20 54 41 42 4c 45 22 20 66 6f 6c  "DROP TABLE" fol
25d0: 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d  lowed.by the nam
25e0: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 20  e of the table. 
25f0: 20 54 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 64   The table named
2600: 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 72   is completely r
2610: 65 6d 6f 76 65 64 20 66 72 6f 6d 0a 74 68 65 20  emoved from.the 
2620: 64 69 73 6b 2e 20 20 54 68 65 20 74 61 62 6c 65  disk.  The table
2630: 20 63 61 6e 20 6e 6f 74 20 62 65 20 72 65 63 6f   can not be reco
2640: 76 65 72 65 64 2e 20 20 41 6c 6c 20 69 6e 64 69  vered.  All indi
2650: 63 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77  ces associated w
2660: 69 74 68 0a 74 68 65 20 74 61 62 6c 65 20 61 72  ith.the table ar
2670: 65 20 61 6c 73 6f 20 64 65 6c 65 74 65 64 2e 3c  e also deleted.<
2680: 2f 70 3e 7d 0a 0a 53 65 63 74 69 6f 6e 20 45 58  /p>}..Section EX
2690: 50 4c 41 49 4e 20 65 78 70 6c 61 69 6e 0a 0a 53  PLAIN explain..S
26a0: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
26b0: 6d 65 6e 74 7d 20 7b 0a 45 58 50 4c 41 49 4e 20  ment} {.EXPLAIN 
26c0: 3c 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 0a  <sql-statement>.
26d0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
26e0: 20 45 58 50 4c 41 49 4e 20 63 6f 6d 6d 61 6e 64   EXPLAIN command
26f0: 20 6d 6f 64 69 66 69 65 72 20 69 73 20 61 20 6e   modifier is a n
2700: 6f 6e 2d 73 74 61 6e 64 61 72 64 20 65 78 74 65  on-standard exte
2710: 6e 73 69 6f 6e 2e 20 20 54 68 65 0a 69 64 65 61  nsion.  The.idea
2720: 20 63 6f 6d 65 73 20 66 72 6f 6d 20 61 20 73 69   comes from a si
2730: 6d 69 6c 61 72 20 63 6f 6d 6d 61 6e 64 20 66 6f  milar command fo
2740: 75 6e 64 20 69 6e 20 50 6f 73 74 67 72 65 53 51  und in PostgreSQ
2750: 4c 2c 20 62 75 74 20 74 68 65 20 6f 70 65 72 61  L, but the opera
2760: 74 69 6f 6e 0a 69 73 20 63 6f 6d 70 6c 65 74 65  tion.is complete
2770: 6c 79 20 64 69 66 66 65 72 65 6e 74 2e 3c 2f 70  ly different.</p
2780: 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20 45 58 50  >..<p>If the EXP
2790: 4c 41 49 4e 20 6b 65 79 77 6f 72 64 20 61 70 70  LAIN keyword app
27a0: 65 61 72 73 20 62 65 66 6f 72 65 20 61 6e 79 20  ears before any 
27b0: 6f 74 68 65 72 20 53 51 4c 69 74 65 20 53 51 4c  other SQLite SQL
27c0: 20 63 6f 6d 6d 61 6e 64 0a 74 68 65 6e 20 69 6e   command.then in
27d0: 73 74 65 61 64 20 6f 66 20 61 63 74 75 61 6c 6c  stead of actuall
27e0: 79 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20  y executing the 
27f0: 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 20 53 51 4c  command, the SQL
2800: 69 74 65 20 6c 69 62 72 61 72 79 20 77 69 6c 6c  ite library will
2810: 0a 72 65 70 6f 72 74 20 62 61 63 6b 20 74 68 65  .report back the
2820: 20 73 65 71 75 65 6e 63 65 20 6f 66 20 76 69 72   sequence of vir
2830: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 69 6e 73  tual machine ins
2840: 74 72 75 63 74 69 6f 6e 73 20 69 74 20 77 6f 75  tructions it wou
2850: 6c 64 20 68 61 76 65 0a 75 73 65 64 20 74 6f 20  ld have.used to 
2860: 65 78 65 63 75 74 65 20 74 68 65 20 63 6f 6d 6d  execute the comm
2870: 61 6e 64 20 68 61 64 20 74 68 65 20 45 58 50 4c  and had the EXPL
2880: 41 49 4e 20 6b 65 79 77 6f 72 64 20 6e 6f 74 20  AIN keyword not 
2890: 62 65 65 6e 20 70 72 65 73 65 6e 74 2e 0a 46 6f  been present..Fo
28a0: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
28b0: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 76  ormation about v
28c0: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 69  irtual machine i
28d0: 6e 73 74 72 75 63 74 69 6f 6e 73 20 73 65 65 0a  nstructions see.
28e0: 74 68 65 20 3c 61 20 68 72 65 66 3d 22 61 72 63  the <a href="arc
28f0: 68 2e 68 74 6d 6c 22 3e 61 72 63 68 69 74 65 63  h.html">architec
2900: 74 75 72 65 20 64 65 73 63 72 69 70 74 69 6f 6e  ture description
2910: 3c 2f 61 3e 20 6f 72 20 74 68 65 20 64 6f 63 75  </a> or the docu
2920: 6d 65 6e 74 61 74 69 6f 6e 0a 6f 6e 20 3c 61 20  mentation.on <a 
2930: 68 72 65 66 3d 22 6f 70 63 6f 64 65 2e 68 74 6d  href="opcode.htm
2940: 6c 22 3e 61 76 61 69 6c 61 62 6c 65 20 6f 70 63  l">available opc
2950: 6f 64 65 73 3c 2f 61 3e 20 66 6f 72 20 74 68 65  odes</a> for the
2960: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
2970: 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
2980: 20 65 78 70 72 65 73 73 69 6f 6e 20 65 78 70 72   expression expr
2990: 0a 0a 53 79 6e 74 61 78 20 7b 65 78 70 72 65 73  ..Syntax {expres
29a0: 73 69 6f 6e 7d 20 7b 0a 3c 65 78 70 72 65 73 73  sion} {.<express
29b0: 69 6f 6e 3e 20 3c 62 69 6e 61 72 79 2d 6f 70 3e  ion> <binary-op>
29c0: 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a   <expression> |.
29d0: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 3c 6c 69  <expression> <li
29e0: 6b 65 2d 6f 70 3e 20 3c 65 78 70 72 65 73 73 69  ke-op> <expressi
29f0: 6f 6e 3e 20 7c 0a 3c 75 6e 61 72 79 2d 6f 70 3e  on> |.<unary-op>
2a00: 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a   <expression> |.
2a10: 28 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 29  ( <expression> )
2a20: 20 7c 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e   |.<column-name>
2a30: 20 7c 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20   |.<table-name> 
2a40: 2e 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20  . <column-name> 
2a50: 7c 0a 3c 6c 69 74 65 72 61 6c 2d 76 61 6c 75 65  |.<literal-value
2a60: 3e 20 7c 0a 3c 66 75 6e 63 74 69 6f 6e 2d 6e 61  > |.<function-na
2a70: 6d 65 3e 20 28 20 3c 65 78 70 72 2d 6c 69 73 74  me> ( <expr-list
2a80: 3e 20 7c 20 53 54 41 52 20 29 20 7c 0a 3c 65 78  > | STAR ) |.<ex
2a90: 70 72 65 73 73 69 6f 6e 3e 20 49 53 4e 55 4c 4c  pression> ISNULL
2aa0: 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20   |.<expression> 
2ab0: 4e 4f 54 4e 55 4c 4c 20 7c 0a 3c 65 78 70 72 65  NOTNULL |.<expre
2ac0: 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d 20 42 45 54  ssion> [NOT] BET
2ad0: 57 45 45 4e 20 3c 65 78 70 72 65 73 73 69 6f 6e  WEEN <expression
2ae0: 3e 20 41 4e 44 20 3c 65 78 70 72 65 73 73 69 6f  > AND <expressio
2af0: 6e 3e 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e  n> |.<expression
2b00: 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28 20 3c 76 61  > [NOT] IN ( <va
2b10: 6c 75 65 2d 6c 69 73 74 3e 20 29 20 7c 0a 3c 65  lue-list> ) |.<e
2b20: 78 70 72 65 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d  xpression> [NOT]
2b30: 20 49 4e 20 28 20 3c 73 65 6c 65 63 74 3e 20 29   IN ( <select> )
2b40: 20 7c 0a 28 20 3c 73 65 6c 65 63 74 3e 20 29 0a   |.( <select> ).
2b50: 7d 20 7b 6c 69 6b 65 2d 6f 70 7d 20 7b 0a 4c 49  } {like-op} {.LI
2b60: 4b 45 20 7c 20 47 4c 4f 42 20 7c 20 4e 4f 54 20  KE | GLOB | NOT 
2b70: 4c 49 4b 45 20 7c 20 4e 4f 54 20 47 4c 4f 42 0a  LIKE | NOT GLOB.
2b80: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 69  }..puts {.<p>Thi
2b90: 73 20 73 65 63 74 69 6f 6e 20 69 73 20 64 69 66  s section is dif
2ba0: 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65 20  ferent from the 
2bb0: 6f 74 68 65 72 73 2e 20 20 45 76 65 72 79 20 6f  others.  Every o
2bc0: 74 68 65 72 20 73 65 63 74 69 6f 6e 20 6f 66 0a  ther section of.
2bd0: 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 74 61  this document ta
2be0: 6c 6b 73 20 61 62 6f 75 74 20 61 20 70 61 72 74  lks about a part
2bf0: 69 63 75 6c 61 72 20 53 51 4c 20 63 6f 6d 6d 61  icular SQL comma
2c00: 6e 64 2e 20 20 54 68 69 73 20 73 65 63 74 69 6f  nd.  This sectio
2c10: 6e 20 64 6f 65 73 0a 6e 6f 74 20 74 61 6c 6b 20  n does.not talk 
2c20: 61 62 6f 75 74 20 61 20 73 74 61 6e 64 61 6c 6f  about a standalo
2c30: 6e 65 20 63 6f 6d 6d 61 6e 64 20 62 75 74 20 61  ne command but a
2c40: 62 6f 75 74 20 22 65 78 70 72 65 73 73 69 6f 6e  bout "expression
2c50: 73 22 20 77 68 69 63 68 20 61 72 65 20 0a 73 75  s" which are .su
2c60: 62 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 6d 6f  bcomponent of mo
2c70: 73 74 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64  st other command
2c80: 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51 4c 69 74  s.</p>..<p>SQLit
2c90: 65 20 75 6e 64 65 72 73 74 61 6e 64 73 20 74 68  e understands th
2ca0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e 61  e following bina
2cb0: 72 79 20 6f 70 65 72 61 74 6f 72 73 2c 20 69 6e  ry operators, in
2cc0: 20 6f 72 64 65 72 20 66 72 6f 6d 0a 68 69 67 68   order from.high
2cd0: 65 73 74 20 74 6f 20 6c 6f 77 65 73 74 20 70 72  est to lowest pr
2ce0: 65 63 65 64 65 6e 63 65 3a 3c 2f 70 3e 0a 0a 3c  ecedence:</p>..<
2cf0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e  blockquote><pre>
2d00: 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32  .<font color="#2
2d10: 63 32 63 66 30 22 3e 3c 62 69 67 3e 2a 20 20 20  c2cf0"><big>*   
2d20: 20 2f 0a 2b 20 20 20 20 2d 0a 26 6c 74 3b 20 20   /.+    -.&lt;  
2d30: 20 20 26 6c 74 3b 3d 20 20 20 26 67 74 3b 20 20    &lt;=   &gt;  
2d40: 20 20 26 67 74 3b 3d 0a 3d 20 20 20 20 3d 3d 20    &gt;=.=    == 
2d50: 20 20 21 3d 20 20 20 26 6c 74 3b 26 67 74 3b 20    !=   &lt;&gt; 
2d60: 20 20 3c 2f 62 69 67 3e 49 4e 0a 41 4e 44 0a 4f    </big>IN.AND.O
2d70: 52 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72 65 3e 3c  R</font>.</pre><
2d80: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70  /blockquote>..<p
2d90: 3e 41 6e 79 20 53 51 4c 69 74 65 20 76 61 6c 75  >Any SQLite valu
2da0: 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73  e can be used as
2db0: 20 70 61 72 74 20 6f 66 20 61 6e 20 65 78 70 72   part of an expr
2dc0: 65 73 73 69 6f 6e 2e 20 20 0a 46 6f 72 20 61 72  ession.  .For ar
2dd0: 69 74 68 6d 65 74 69 63 20 6f 70 65 72 61 74 69  ithmetic operati
2de0: 6f 6e 73 2c 20 69 6e 74 65 67 65 72 73 20 61 72  ons, integers ar
2df0: 65 20 74 72 65 61 74 65 64 20 61 73 20 69 6e 74  e treated as int
2e00: 65 67 65 72 73 2e 0a 53 74 72 69 6e 67 73 20 61  egers..Strings a
2e10: 72 65 20 66 69 72 73 74 20 63 6f 6e 76 65 72 74  re first convert
2e20: 65 64 20 74 6f 20 72 65 61 6c 20 6e 75 6d 62 65  ed to real numbe
2e30: 72 73 20 75 73 69 6e 67 20 3c 62 3e 61 74 6f 66  rs using <b>atof
2e40: 28 29 3c 2f 62 3e 2e 0a 46 6f 72 20 63 6f 6d 70  ()</b>..For comp
2e50: 61 72 69 73 6f 6e 20 6f 70 65 72 61 74 6f 72 73  arison operators
2e60: 2c 20 6e 75 6d 62 65 72 73 20 63 6f 6d 70 61 72  , numbers compar
2e70: 65 20 61 73 20 6e 75 6d 62 65 72 73 20 61 6e 64  e as numbers and
2e80: 20 73 74 72 69 6e 67 73 0a 63 6f 6d 70 61 72 65   strings.compare
2e90: 20 61 73 20 73 74 72 69 6e 67 73 2e 20 20 46 6f   as strings.  Fo
2ea0: 72 20 73 74 72 69 6e 67 20 63 6f 6d 70 61 72 69  r string compari
2eb0: 73 6f 6e 73 2c 20 63 61 73 65 20 69 73 20 73 69  sons, case is si
2ec0: 67 6e 69 66 69 63 61 6e 74 0a 62 75 74 20 69 73  gnificant.but is
2ed0: 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f 20 62 72   only used to br
2ee0: 65 61 6b 20 61 20 74 69 65 2e 0a 4e 6f 74 65 20  eak a tie..Note 
2ef0: 74 68 61 74 20 74 68 65 72 65 20 61 72 65 20 74  that there are t
2f00: 77 6f 20 76 61 72 69 61 74 69 6f 6e 73 20 6f 66  wo variations of
2f10: 20 74 68 65 20 65 71 75 61 6c 73 20 61 6e 64 20   the equals and 
2f20: 6e 6f 74 20 65 71 75 61 6c 73 0a 6f 70 65 72 61  not equals.opera
2f30: 74 6f 72 73 2e 20 20 45 71 75 61 6c 73 20 63 61  tors.  Equals ca
2f40: 6e 20 62 65 20 65 69 74 68 65 72 7d 0a 70 75 74  n be either}.put
2f50: 73 20 22 5b 4f 70 65 72 61 74 6f 72 20 3d 5d 20  s "[Operator =] 
2f60: 6f 72 20 5b 4f 70 65 72 61 74 6f 72 20 3d 3d 5d  or [Operator ==]
2f70: 2e 0a 54 68 65 20 6e 6f 6e 2d 65 71 75 61 6c 73  ..The non-equals
2f80: 20 6f 70 65 72 61 74 6f 72 20 63 61 6e 20 62 65   operator can be
2f90: 20 65 69 74 68 65 72 0a 5b 4f 70 65 72 61 74 6f   either.[Operato
2fa0: 72 20 21 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74  r !=] or [Operat
2fb0: 6f 72 20 7b 26 6c 74 3b 26 67 74 3b 7d 5d 2e 3c  or {&lt;&gt;}].<
2fc0: 2f 70 3e 22 0a 70 75 74 73 20 7b 0a 0a 3c 70 3e  /p>".puts {..<p>
2fd0: 54 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  The LIKE operato
2fe0: 72 20 64 6f 65 73 20 61 20 77 69 6c 64 63 61 72  r does a wildcar
2ff0: 64 20 63 6f 6d 70 61 72 69 73 69 6f 6e 2e 20 20  d comparision.  
3000: 54 68 65 20 6f 70 65 72 61 6e 64 0a 74 6f 20 74  The operand.to t
3010: 68 65 20 72 69 67 68 74 20 63 6f 6e 74 61 69 6e  he right contain
3020: 73 20 74 68 65 20 77 69 6c 64 63 61 72 64 73 2e  s the wildcards.
3030: 7d 0a 70 75 74 73 20 22 41 20 70 65 72 63 65 6e  }.puts "A percen
3040: 74 20 73 79 6d 62 6f 6c 20 5b 4f 70 65 72 61 74  t symbol [Operat
3050: 6f 72 20 25 5d 20 69 6e 20 74 68 65 20 72 69 67  or %] in the rig
3060: 68 74 20 6f 70 65 72 61 6e 64 0a 6d 61 74 63 68  ht operand.match
3070: 65 73 20 61 6e 79 20 73 65 71 75 65 6e 63 65 20  es any sequence 
3080: 6f 66 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20  of zero or more 
3090: 63 68 61 72 61 63 74 65 72 73 20 6f 6e 20 74 68  characters on th
30a0: 65 20 6c 65 66 74 2e 0a 41 6e 20 75 6e 64 65 72  e left..An under
30b0: 73 63 6f 72 65 20 5b 4f 70 65 72 61 74 6f 72 20  score [Operator 
30c0: 5f 5d 20 6f 6e 20 74 68 65 20 72 69 67 68 74 0a  _] on the right.
30d0: 6d 61 74 63 68 65 73 20 61 6e 79 20 73 69 6e 67  matches any sing
30e0: 6c 65 20 63 68 61 72 61 63 74 65 72 20 6f 6e 20  le character on 
30f0: 74 68 65 20 6c 65 66 74 2e 22 0a 70 75 74 73 20  the left.".puts 
3100: 7b 54 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74  {The LIKE operat
3110: 6f 72 20 69 73 0a 6e 6f 74 20 63 61 73 65 20 73  or is.not case s
3120: 65 6e 73 69 74 69 76 65 20 61 6e 64 20 77 69 6c  ensitive and wil
3130: 6c 20 6d 61 74 63 68 20 75 70 70 65 72 20 63 61  l match upper ca
3140: 73 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e  se characters on
3150: 20 6f 6e 65 0a 73 69 64 65 20 61 67 61 69 6e 73   one.side agains
3160: 74 20 6c 6f 77 65 72 20 63 61 73 65 20 63 68 61  t lower case cha
3170: 72 61 63 74 65 72 73 20 6f 6e 20 74 68 65 20 6f  racters on the o
3180: 74 68 65 72 2e 0a 28 41 20 62 75 67 3a 20 53 51  ther..(A bug: SQ
3190: 4c 69 74 65 20 6f 6e 6c 79 20 75 6e 64 65 72 73  Lite only unders
31a0: 74 61 6e 64 73 20 75 70 70 65 72 2f 6c 6f 77 65  tands upper/lowe
31b0: 72 20 63 61 73 65 20 66 6f 72 20 37 2d 62 69 74  r case for 7-bit
31c0: 20 4c 61 74 69 6e 0a 63 68 61 72 61 63 74 65 72   Latin.character
31d0: 73 2e 20 20 48 65 6e 63 65 20 74 68 65 20 4c 49  s.  Hence the LI
31e0: 4b 45 20 6f 70 65 72 61 74 6f 72 20 69 73 20 63  KE operator is c
31f0: 61 73 65 20 73 65 6e 73 69 74 69 76 65 20 66 6f  ase sensitive fo
3200: 72 0a 38 2d 62 69 74 20 69 73 6f 38 38 35 39 20  r.8-bit iso8859 
3210: 63 68 61 72 61 63 74 65 72 73 20 6f 72 20 55 54  characters or UT
3220: 46 2d 38 20 63 68 61 72 61 63 74 65 72 73 2e 20  F-8 characters. 
3230: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 74 68   For example,.th
3240: 65 20 65 78 70 72 65 73 73 69 6f 6e 20 3c 62 3e  e expression <b>
3250: 27 61 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62  'a'&nbsp;LIKE&nb
3260: 73 70 3b 27 41 27 3c 2f 62 3e 20 69 73 20 54 52  sp;'A'</b> is TR
3270: 55 45 20 62 75 74 0a 3c 62 3e 27 26 61 65 6c 69  UE but.<b>'&aeli
3280: 67 3b 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62  g;'&nbsp;LIKE&nb
3290: 73 70 3b 27 26 41 45 6c 69 67 3b 27 3c 2f 62 3e  sp;'&AElig;'</b>
32a0: 20 69 73 20 46 41 4c 53 45 2e 29 0a 3c 2f 70 3e   is FALSE.).</p>
32b0: 0a 0a 3c 70 3e 54 68 65 20 47 4c 4f 42 20 6f 70  ..<p>The GLOB op
32c0: 65 72 61 74 6f 72 20 69 73 20 73 69 6d 69 6c 61  erator is simila
32d0: 72 20 74 6f 20 4c 49 4b 45 20 62 75 74 20 75 73  r to LIKE but us
32e0: 65 73 20 74 68 65 20 55 6e 69 78 0a 66 69 6c 65  es the Unix.file
32f0: 20 67 6c 6f 62 62 69 6e 67 20 73 79 6e 74 61 78   globbing syntax
3300: 20 66 6f 72 20 69 74 73 20 77 69 6c 64 63 61 72   for its wildcar
3310: 64 73 2e 20 20 41 6c 73 6f 2c 20 47 4c 4f 42 20  ds.  Also, GLOB 
3320: 69 73 20 63 61 73 65 0a 73 65 6e 73 69 74 69 76  is case.sensitiv
3330: 65 2c 20 75 6e 6c 69 6b 65 20 4c 49 4b 45 2e 20  e, unlike LIKE. 
3340: 20 42 6f 74 68 20 47 4c 4f 42 20 61 6e 64 20 4c   Both GLOB and L
3350: 49 4b 45 20 6d 61 79 20 62 65 20 70 72 65 63 65  IKE may be prece
3360: 64 65 64 20 62 79 0a 74 68 65 20 4e 4f 54 20 6b  ded by.the NOT k
3370: 65 79 77 6f 72 64 20 74 6f 20 69 6e 76 65 72 74  eyword to invert
3380: 20 74 68 65 20 73 65 6e 73 65 20 6f 66 20 74 68   the sense of th
3390: 65 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e  e test.</p>..<p>
33a0: 41 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61  A column name ca
33b0: 6e 20 62 65 20 61 6e 79 20 6f 66 20 74 68 65 20  n be any of the 
33c0: 6e 61 6d 65 73 20 64 65 66 69 6e 65 64 20 69 6e  names defined in
33d0: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
33e0: 45 0a 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 6f  E.statement or o
33f0: 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  ne of the follow
3400: 69 6e 67 20 73 70 65 63 69 61 6c 20 69 64 65 6e  ing special iden
3410: 74 69 66 69 65 72 73 3a 20 22 3c 62 3e 52 4f 57  tifiers: "<b>ROW
3420: 49 44 3c 2f 62 3e 22 2c 0a 22 3c 62 3e 4f 49 44  ID</b>",."<b>OID
3430: 3c 2f 62 3e 22 2c 20 6f 72 20 22 3c 62 3e 5f 52  </b>", or "<b>_R
3440: 4f 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54 68 65 73  OWID_</b>"..Thes
3450: 65 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74 69  e special identi
3460: 66 69 65 72 73 20 61 6c 6c 20 64 65 73 63 72 69  fiers all descri
3470: 62 65 20 74 68 65 0a 75 6e 69 71 75 65 20 72 61  be the.unique ra
3480: 6e 64 6f 6d 20 69 6e 74 65 67 65 72 20 6b 65 79  ndom integer key
3490: 20 28 74 68 65 20 22 72 6f 77 20 6b 65 79 22 29   (the "row key")
34a0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
34b0: 20 65 76 65 72 79 20 0a 72 6f 77 20 6f 66 20 65   every .row of e
34c0: 76 65 72 79 20 74 61 62 6c 65 2e 0a 54 68 65 20  very table..The 
34d0: 73 70 65 63 69 61 6c 20 69 64 65 6e 74 69 66 69  special identifi
34e0: 65 72 73 20 6f 6e 6c 79 20 72 65 66 65 72 20 74  ers only refer t
34f0: 6f 20 74 68 65 20 72 6f 77 20 6b 65 79 20 69 66  o the row key if
3500: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
3510: 45 0a 73 74 61 74 65 6d 65 6e 74 20 64 6f 65 73  E.statement does
3520: 20 6e 6f 74 20 64 65 66 69 6e 65 20 61 20 72 65   not define a re
3530: 61 6c 20 63 6f 6c 75 6d 6e 20 77 69 74 68 20 74  al column with t
3540: 68 65 20 73 61 6d 65 20 6e 61 6d 65 2e 20 20 52  he same name.  R
3550: 6f 77 20 6b 65 79 73 0a 61 63 74 20 6c 69 6b 65  ow keys.act like
3560: 20 72 65 61 64 2d 6f 6e 6c 79 20 63 6f 6c 75 6d   read-only colum
3570: 6e 73 2e 20 20 41 20 72 6f 77 20 6b 65 79 20 63  ns.  A row key c
3580: 61 6e 20 62 65 20 75 73 65 64 20 61 6e 79 77 68  an be used anywh
3590: 65 72 65 20 61 20 72 65 67 75 6c 61 72 0a 63 6f  ere a regular.co
35a0: 6c 75 6d 6e 20 63 61 6e 20 62 65 20 75 73 65 64  lumn can be used
35b0: 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 79 6f  , except that yo
35c0: 75 20 63 61 6e 6e 6f 74 20 63 68 61 6e 67 65 20  u cannot change 
35d0: 74 68 65 20 76 61 6c 75 65 0a 6f 66 20 61 20 72  the value.of a r
35e0: 6f 77 20 6b 65 79 20 69 6e 20 61 6e 20 55 50 44  ow key in an UPD
35f0: 41 54 45 20 6f 72 20 49 4e 53 45 52 54 20 73 74  ATE or INSERT st
3600: 61 74 65 6d 65 6e 74 2e 0a 22 53 45 4c 45 43 54  atement.."SELECT
3610: 20 2a 20 2e 2e 2e 22 20 64 6f 65 73 20 6e 6f 74   * ..." does not
3620: 20 72 65 74 75 72 6e 20 74 68 65 20 72 6f 77 20   return the row 
3630: 6b 65 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 45 4c  key.</p>..<p>SEL
3640: 45 43 54 20 73 74 61 74 65 6d 65 6e 74 73 20 63  ECT statements c
3650: 61 6e 20 61 70 70 65 61 72 20 69 6e 20 65 78 70  an appear in exp
3660: 72 65 73 73 69 6f 6e 73 20 61 73 20 65 69 74 68  ressions as eith
3670: 65 72 20 74 68 65 0a 72 69 67 68 74 2d 68 61 6e  er the.right-han
3680: 64 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68 65  d operand of the
3690: 20 49 4e 20 6f 70 65 72 61 74 6f 72 20 6f 72 20   IN operator or 
36a0: 61 73 20 61 20 73 63 61 6c 61 72 20 71 75 61 6e  as a scalar quan
36b0: 74 69 74 79 2e 0a 49 6e 20 62 6f 74 68 20 63 61  tity..In both ca
36c0: 73 65 73 2c 20 74 68 65 20 53 45 4c 45 43 54 20  ses, the SELECT 
36d0: 73 68 6f 75 6c 64 20 68 61 76 65 20 6f 6e 6c 79  should have only
36e0: 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e   a single column
36f0: 20 69 6e 20 69 74 73 0a 72 65 73 75 6c 74 2e 20   in its.result. 
3700: 20 43 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54   Compound SELECT
3710: 73 20 28 63 6f 6e 6e 65 63 74 65 64 20 77 69 74  s (connected wit
3720: 68 20 6b 65 79 77 6f 72 64 73 20 6c 69 6b 65 20  h keywords like 
3730: 55 4e 49 4f 4e 20 6f 72 0a 45 58 43 45 50 54 29  UNION or.EXCEPT)
3740: 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 20 20 41   are allowed.  A
3750: 6e 79 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75  ny ORDER BY clau
3760: 73 65 20 6f 6e 20 74 68 65 20 73 65 6c 65 63 74  se on the select
3770: 20 69 73 20 69 67 6e 6f 72 65 64 2e 0a 41 20 53   is ignored..A S
3780: 45 4c 45 43 54 20 69 6e 20 61 6e 20 65 78 70 72  ELECT in an expr
3790: 65 73 73 69 6f 6e 20 69 73 20 65 76 61 6c 75 61  ession is evalua
37a0: 74 65 64 20 6f 6e 63 65 20 62 65 66 6f 72 65 20  ted once before 
37b0: 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73  any other proces
37c0: 73 69 6e 67 0a 69 73 20 70 65 72 66 6f 72 6d 65  sing.is performe
37d0: 64 2c 20 73 6f 20 6e 6f 6e 65 20 6f 66 20 74 68  d, so none of th
37e0: 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 77 69  e expressions wi
37f0: 74 68 69 6e 20 74 68 65 20 73 65 6c 65 63 74 20  thin the select 
3800: 69 74 73 65 6c 66 20 63 61 6e 0a 72 65 66 65 72  itself can.refer
3810: 20 74 6f 20 71 75 61 6e 74 69 74 69 65 73 20 69   to quantities i
3820: 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e 69 6e 67  n the containing
3830: 20 65 78 70 72 65 73 73 69 6f 6e 2e 3c 2f 70 3e   expression.</p>
3840: 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c 45  ..<p>When a SELE
3850: 43 54 20 69 73 20 74 68 65 20 72 69 67 68 74 20  CT is the right 
3860: 6f 70 65 72 61 6e 64 20 6f 66 20 74 68 65 20 49  operand of the I
3870: 4e 20 6f 70 65 72 61 74 6f 72 2c 20 74 68 65 20  N operator, the 
3880: 49 4e 0a 6f 70 65 72 61 74 6f 72 20 72 65 74 75  IN.operator retu
3890: 72 6e 73 20 54 52 55 45 20 69 66 20 74 68 65 20  rns TRUE if the 
38a0: 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 6c 65  result of the le
38b0: 66 74 20 6f 70 65 72 61 6e 64 20 69 73 20 61 6e  ft operand is an
38c0: 79 20 6f 66 0a 74 68 65 20 76 61 6c 75 65 73 20  y of.the values 
38d0: 67 65 6e 65 72 61 74 65 64 20 62 79 20 74 68 65  generated by the
38e0: 20 73 65 6c 65 63 74 2e 20 20 54 68 65 20 49 4e   select.  The IN
38f0: 20 6f 70 65 72 61 74 6f 72 20 6d 61 79 20 62 65   operator may be
3900: 20 70 72 65 63 65 64 65 64 0a 62 79 20 74 68 65   preceded.by the
3910: 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20 74 6f 20   NOT keyword to 
3920: 69 6e 76 65 72 74 20 74 68 65 20 73 65 6e 73 65  invert the sense
3930: 20 6f 66 20 74 68 65 20 74 65 73 74 2e 3c 2f 70   of the test.</p
3940: 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c  >..<p>When a SEL
3950: 45 43 54 20 61 70 70 65 61 72 73 20 77 69 74 68  ECT appears with
3960: 69 6e 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e  in an expression
3970: 20 62 75 74 20 69 73 20 6e 6f 74 20 74 68 65 20   but is not the 
3980: 72 69 67 68 74 0a 6f 70 65 72 61 6e 64 20 6f 66  right.operand of
3990: 20 61 6e 20 49 4e 20 6f 70 65 72 61 74 6f 72 2c   an IN operator,
39a0: 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 74 20   then the first 
39b0: 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c  row of the resul
39c0: 74 20 6f 66 20 74 68 65 0a 53 45 4c 45 43 54 20  t of the.SELECT 
39d0: 62 65 63 6f 6d 65 73 20 74 68 65 20 76 61 6c 75  becomes the valu
39e0: 65 20 75 73 65 64 20 69 6e 20 74 68 65 20 65 78  e used in the ex
39f0: 70 72 65 73 73 69 6f 6e 2e 20 20 49 66 20 74 68  pression.  If th
3a00: 65 20 53 45 4c 45 43 54 20 79 69 65 6c 64 73 0a  e SELECT yields.
3a10: 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 65  more than one re
3a20: 73 75 6c 74 20 72 6f 77 2c 20 61 6c 6c 20 72 6f  sult row, all ro
3a30: 77 73 20 61 66 74 65 72 20 74 68 65 20 66 69 72  ws after the fir
3a40: 73 74 20 61 72 65 20 69 67 6e 6f 72 65 64 2e 20  st are ignored. 
3a50: 20 49 66 0a 74 68 65 20 53 45 4c 45 43 54 20 79   If.the SELECT y
3a60: 65 69 6c 64 73 20 6e 6f 20 72 6f 77 73 2c 20 74  eilds no rows, t
3a70: 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66  hen the value of
3a80: 20 74 68 65 20 53 45 4c 45 43 54 20 69 73 20 4e   the SELECT is N
3a90: 55 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ULL.</p>..<p>The
3aa0: 20 65 78 70 72 65 73 73 69 6f 6e 20 73 79 6e 74   expression synt
3ab0: 61 78 20 63 75 72 72 65 6e 74 6c 79 20 73 75 70  ax currently sup
3ac0: 70 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f 77  ports the follow
3ad0: 69 6e 67 0a 66 75 6e 63 74 69 6f 6e 73 3a 3c 2f  ing.functions:</
3ae0: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  p>..<blockquote>
3af0: 3c 70 72 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f  <pre>.<font colo
3b00: 72 3d 22 23 32 63 32 63 66 30 22 3e 3c 62 69 67  r="#2c2cf0"><big
3b10: 3e 63 6f 75 6e 74 20 20 20 20 6d 69 6e 20 20 20  >count    min   
3b20: 20 20 20 20 6d 61 78 20 20 20 20 20 20 20 73 75      max       su
3b30: 6d 0a 61 76 67 20 20 20 20 20 20 6c 65 6e 67 74  m.avg      lengt
3b40: 68 20 20 20 20 73 75 62 73 74 72 3c 2f 62 69 67  h    substr</big
3b50: 3e 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72 65 3e 3c  ></font>.</pre><
3b60: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70  /blockquote>..<p
3b70: 3e 0a 54 68 65 20 66 75 6e 63 74 69 6f 6e 73 20  >.The functions 
3b80: 3c 62 3e 63 6f 75 6e 74 3c 2f 62 3e 2c 20 3c 62  <b>count</b>, <b
3b90: 3e 73 75 6d 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62  >sum</b>, and <b
3ba0: 3e 61 76 67 3c 2f 62 3e 20 61 6e 64 20 74 68 65  >avg</b> and the
3bb0: 20 66 75 6e 63 74 69 6f 6e 73 0a 3c 62 3e 6d 69   functions.<b>mi
3bc0: 6e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 6d 61 78  n</b> and <b>max
3bd0: 3c 2f 62 3e 20 75 73 65 64 20 77 69 74 68 20 6f  </b> used with o
3be0: 6e 6c 79 20 6f 6e 65 20 61 72 67 75 6d 65 6e 74  nly one argument
3bf0: 20 61 72 65 20 61 6c 6c 20 61 67 67 72 65 67 61   are all aggrega
3c00: 74 65 0a 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54  te.functions.  T
3c10: 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 74  his means that t
3c20: 68 65 79 20 61 72 65 20 63 6f 6d 70 75 74 65 64  hey are computed
3c30: 20 61 63 72 6f 73 73 20 61 6c 6c 20 72 6f 77 73   across all rows
3c40: 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 2e 0a   of the result..
3c50: 54 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 3c 62  The functions <b
3c60: 3e 6d 69 6e 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e  >min</b> and <b>
3c70: 6d 61 78 3c 2f 62 3e 0a 77 69 74 68 20 74 77 6f  max</b>.with two
3c80: 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 6d 65 6e   or more argumen
3c90: 74 73 20 61 6e 64 20 74 68 65 20 0a 66 75 6e 63  ts and the .func
3ca0: 74 69 6f 6e 73 20 3c 62 3e 6c 65 6e 67 74 68 3c  tions <b>length<
3cb0: 2f 62 3e 20 61 6e 64 20 3c 62 3e 73 75 62 73 74  /b> and <b>subst
3cc0: 72 3c 2f 62 3e 0a 61 72 65 20 6e 6f 6e 2d 61 67  r</b>.are non-ag
3cd0: 67 72 65 67 61 74 65 73 2e 20 20 4e 6f 6e 2d 61  gregates.  Non-a
3ce0: 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f  ggregate functio
3cf0: 6e 73 0a 61 72 65 20 63 6f 6d 70 75 74 65 64 20  ns.are computed 
3d00: 73 65 70 61 72 61 74 65 6c 79 20 66 6f 72 20 65  separately for e
3d10: 61 63 68 20 72 6f 77 20 6f 66 20 74 68 65 20 72  ach row of the r
3d20: 65 73 75 6c 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e  esult..</p>..<p>
3d30: 0a 54 68 65 20 22 3c 62 3e 63 6f 75 6e 74 28 2a  .The "<b>count(*
3d40: 29 3c 2f 62 3e 22 20 73 79 6e 74 61 78 20 69 73  )</b>" syntax is
3d50: 20 73 75 70 70 6f 72 74 65 64 20 62 75 74 0a 22   supported but."
3d60: 3c 62 3e 63 6f 75 6e 74 28 64 69 73 74 69 6e 63  <b>count(distinc
3d70: 74 3c 2f 62 3e 20 3c 69 3e 43 4f 4c 55 4d 4e 2d  t</b> <i>COLUMN-
3d80: 4e 41 4d 45 3c 2f 69 3e 3c 62 3e 29 3c 2f 62 3e  NAME</i><b>)</b>
3d90: 22 20 69 73 20 6e 6f 74 2e 0a 3c 2f 70 3e 0a 7d  " is not..</p>.}
3da0: 0a 0a 53 65 63 74 69 6f 6e 20 49 4e 53 45 52 54  ..Section INSERT
3db0: 20 69 6e 73 65 72 74 0a 0a 53 79 6e 74 61 78 20   insert..Syntax 
3dc0: 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20  {sql-statement} 
3dd0: 7b 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 3c 74  {.INSERT INTO <t
3de0: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63  able-name> [( <c
3df0: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 56  olumn-list> )] V
3e00: 41 4c 55 45 53 20 28 20 3c 76 61 6c 75 65 2d 6c  ALUES ( <value-l
3e10: 69 73 74 3e 20 29 20 7c 0a 49 4e 53 45 52 54 20  ist> ) |.INSERT 
3e20: 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65  INTO <table-name
3e30: 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73  > [( <column-lis
3e40: 74 3e 20 29 5d 20 3c 73 65 6c 65 63 74 2d 73 74  t> )] <select-st
3e50: 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73  atement>.}..puts
3e60: 20 7b 0a 3c 70 3e 54 68 65 20 49 4e 53 45 52 54   {.<p>The INSERT
3e70: 20 73 74 61 74 65 6d 65 6e 74 20 63 6f 6d 65 73   statement comes
3e80: 20 69 6e 20 74 77 6f 20 62 61 73 69 63 20 66 6f   in two basic fo
3e90: 72 6d 73 2e 20 20 54 68 65 20 66 69 72 73 74 20  rms.  The first 
3ea0: 66 6f 72 6d 0a 28 77 69 74 68 20 74 68 65 20 22  form.(with the "
3eb0: 56 41 4c 55 45 53 22 20 6b 65 79 77 6f 72 64 29  VALUES" keyword)
3ec0: 20 63 72 65 61 74 65 73 20 61 20 73 69 6e 67 6c   creates a singl
3ed0: 65 20 6e 65 77 20 72 6f 77 20 69 6e 20 61 6e 20  e new row in an 
3ee0: 65 78 69 73 74 69 6e 67 20 74 61 62 6c 65 2e 0a  existing table..
3ef0: 49 66 20 6e 6f 20 63 6f 6c 75 6d 6e 2d 6c 69 73  If no column-lis
3f00: 74 20 69 73 20 73 70 65 63 69 66 69 65 64 20 74  t is specified t
3f10: 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  hen the number o
3f20: 66 20 76 61 6c 75 65 73 20 6d 75 73 74 0a 62 65  f values must.be
3f30: 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65   the same as the
3f40: 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d   number of colum
3f50: 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e  ns in the table.
3f60: 20 20 49 66 20 61 20 63 6f 6c 75 6d 6e 2d 6c 69    If a column-li
3f70: 73 74 0a 69 73 20 73 70 65 63 69 66 69 65 64 2c  st.is specified,
3f80: 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72   then the number
3f90: 20 6f 66 20 76 61 6c 75 65 73 20 6d 75 73 74 20   of values must 
3fa0: 6d 61 74 63 68 20 74 68 65 20 6e 75 6d 62 65 72  match the number
3fb0: 20 6f 66 0a 73 70 65 63 69 66 69 65 64 20 63 6f   of.specified co
3fc0: 6c 75 6d 6e 73 2e 20 20 43 6f 6c 75 6d 6e 73 20  lumns.  Columns 
3fd0: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  of the table tha
3fe0: 74 20 64 6f 20 6e 6f 74 20 61 70 70 65 61 72 20  t do not appear 
3ff0: 69 6e 20 74 68 65 0a 63 6f 6c 75 6d 6e 20 6c 69  in the.column li
4000: 73 74 20 61 72 65 20 66 69 6c 6c 20 77 69 74 68  st are fill with
4010: 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c   the default val
4020: 75 65 2c 20 6f 72 20 77 69 74 68 20 4e 55 4c 4c  ue, or with NULL
4030: 20 69 66 20 6e 6f 74 0a 64 65 66 61 75 6c 74 20   if not.default 
4040: 76 61 6c 75 65 20 69 73 20 73 70 65 63 69 66 69  value is specifi
4050: 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ed..</p>..<p>The
4060: 20 73 65 63 6f 6e 64 20 66 6f 72 6d 20 6f 66 20   second form of 
4070: 74 68 65 20 49 4e 53 45 52 54 20 73 74 61 74 65  the INSERT state
4080: 6d 65 6e 74 20 74 61 6b 65 73 20 69 74 20 64 61  ment takes it da
4090: 74 61 20 66 72 6f 6d 20 61 0a 53 45 4c 45 43 54  ta from a.SELECT
40a0: 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 54 68 65   statement.  The
40b0: 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d   number of colum
40c0: 6e 73 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74  ns in the result
40d0: 20 6f 66 20 74 68 65 0a 53 45 4c 45 43 54 20 6d   of the.SELECT m
40e0: 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63  ust exactly matc
40f0: 68 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  h the number of 
4100: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74  columns in the t
4110: 61 62 6c 65 20 69 66 0a 6e 6f 20 63 6f 6c 75 6d  able if.no colum
4120: 6e 20 6c 69 73 74 20 69 73 20 73 70 65 63 69 66  n list is specif
4130: 69 65 64 2c 20 6f 72 20 69 74 20 6d 75 73 74 20  ied, or it must 
4140: 6d 61 74 63 68 20 74 68 65 20 6e 75 6d 62 65 72  match the number
4150: 20 6f 66 20 63 6f 6c 75 6d 6e 73 0a 6e 61 6d 65   of columns.name
4160: 20 69 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6c   in the column l
4170: 69 73 74 2e 20 20 41 20 6e 65 77 20 65 6e 74 72  ist.  A new entr
4180: 79 20 69 73 20 6d 61 64 65 20 69 6e 20 74 68 65  y is made in the
4190: 20 74 61 62 6c 65 0a 66 6f 72 20 65 76 65 72 79   table.for every
41a0: 20 72 6f 77 20 6f 66 20 74 68 65 20 53 45 4c 45   row of the SELE
41b0: 43 54 20 72 65 73 75 6c 74 2e 20 20 54 68 65 20  CT result.  The 
41c0: 53 45 4c 45 43 54 20 6d 61 79 20 62 65 20 73 69  SELECT may be si
41d0: 6d 70 6c 65 0a 6f 72 20 63 6f 6d 70 6f 75 6e 64  mple.or compound
41e0: 2e 20 20 49 66 20 74 68 65 20 53 45 4c 45 43 54  .  If the SELECT
41f0: 20 73 74 61 74 65 6d 65 6e 74 20 68 61 73 20 61   statement has a
4200: 6e 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  n ORDER BY claus
4210: 65 2c 0a 74 68 65 20 4f 52 44 45 52 20 42 59 20  e,.the ORDER BY 
4220: 69 73 20 69 67 6e 6f 72 65 64 2e 3c 2f 70 3e 0a  is ignored.</p>.
4230: 7d 0a 0a 53 65 63 74 69 6f 6e 20 53 45 4c 45 43  }..Section SELEC
4240: 54 20 73 65 6c 65 63 74 0a 0a 53 79 6e 74 61 78  T select..Syntax
4250: 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d   {sql-statement}
4260: 20 7b 0a 53 45 4c 45 43 54 20 3c 72 65 73 75 6c   {.SELECT <resul
4270: 74 3e 20 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6c  t> FROM <table-l
4280: 69 73 74 3e 20 0a 5b 57 48 45 52 45 20 3c 65 78  ist> .[WHERE <ex
4290: 70 72 65 73 73 69 6f 6e 3e 5d 0a 5b 47 52 4f 55  pression>].[GROU
42a0: 50 20 42 59 20 3c 65 78 70 72 2d 6c 69 73 74 3e  P BY <expr-list>
42b0: 5d 0a 5b 48 41 56 49 4e 47 20 3c 65 78 70 72 65  ].[HAVING <expre
42c0: 73 73 69 6f 6e 3e 5d 0a 5b 3c 63 6f 6d 70 6f 75  ssion>].[<compou
42d0: 6e 64 2d 6f 70 3e 20 3c 73 65 6c 65 63 74 3e 5d  nd-op> <select>]
42e0: 2a 0a 5b 4f 52 44 45 52 20 42 59 20 3c 73 6f 72  *.[ORDER BY <sor
42f0: 74 2d 65 78 70 72 2d 6c 69 73 74 3e 5d 0a 7d 20  t-expr-list>].} 
4300: 7b 72 65 73 75 6c 74 7d 20 7b 0a 53 54 41 52 20  {result} {.STAR 
4310: 7c 20 3c 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e  | <result-column
4320: 3e 20 5b 2c 20 3c 72 65 73 75 6c 74 2d 63 6f 6c  > [, <result-col
4330: 75 6d 6e 3e 5d 2a 0a 7d 20 7b 72 65 73 75 6c 74  umn>]*.} {result
4340: 2d 63 6f 6c 75 6d 6e 7d 20 7b 0a 3c 65 78 70 72  -column} {.<expr
4350: 65 73 73 69 6f 6e 3e 20 5b 20 5b 41 53 5d 20 3c  ession> [ [AS] <
4360: 73 74 72 69 6e 67 3e 20 5d 0a 7d 20 7b 74 61 62  string> ].} {tab
4370: 6c 65 2d 6c 69 73 74 7d 20 7b 0a 3c 74 61 62 6c  le-list} {.<tabl
4380: 65 2d 6e 61 6d 65 3e 20 5b 2c 20 3c 74 61 62 6c  e-name> [, <tabl
4390: 65 2d 6e 61 6d 65 3e 5d 2a 0a 7d 20 7b 73 6f 72  e-name>]*.} {sor
43a0: 74 2d 65 78 70 72 2d 6c 69 73 74 7d 20 7b 0a 3c  t-expr-list} {.<
43b0: 65 78 70 72 3e 20 5b 3c 73 6f 72 74 2d 6f 72 64  expr> [<sort-ord
43c0: 65 72 3e 5d 20 5b 2c 20 3c 65 78 70 72 3e 20 5b  er>] [, <expr> [
43d0: 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 5d 2a 0a  <sort-order>]]*.
43e0: 7d 20 7b 73 6f 72 74 2d 6f 72 64 65 72 7d 20 7b  } {sort-order} {
43f0: 0a 41 53 43 20 7c 20 44 45 53 43 0a 7d 20 7b 63  .ASC | DESC.} {c
4400: 6f 6d 70 6f 75 6e 64 5f 6f 70 7d 20 7b 0a 55 4e  ompound_op} {.UN
4410: 49 4f 4e 20 7c 20 55 4e 49 4f 4e 20 41 4c 4c 20  ION | UNION ALL 
4420: 7c 20 49 4e 54 45 52 53 45 43 54 20 7c 20 45 58  | INTERSECT | EX
4430: 43 45 50 54 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  CEPT.}..puts {.<
4440: 70 3e 54 68 65 20 53 45 4c 45 43 54 20 73 74 61  p>The SELECT sta
4450: 74 65 6d 65 6e 74 20 69 73 20 75 73 65 64 20 74  tement is used t
4460: 6f 20 71 75 65 72 79 20 74 68 65 20 64 61 74 61  o query the data
4470: 62 61 73 65 2e 20 20 54 68 65 0a 72 65 73 75 6c  base.  The.resul
4480: 74 20 6f 66 20 61 20 53 45 4c 45 43 54 20 69 73  t of a SELECT is
4490: 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 72 6f   zero or more ro
44a0: 77 73 20 6f 66 20 64 61 74 61 20 77 68 65 72 65  ws of data where
44b0: 20 65 61 63 68 20 72 6f 77 0a 68 61 73 20 61 20   each row.has a 
44c0: 66 69 78 65 64 20 6e 75 6d 62 65 72 20 6f 66 20  fixed number of 
44d0: 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 20 6e 75  columns.  The nu
44e0: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
44f0: 69 6e 20 74 68 65 0a 72 65 73 75 6c 74 20 69 73  in the.result is
4500: 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68   specified by th
4510: 65 20 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 73  e expression lis
4520: 74 20 69 6e 20 62 65 74 77 65 65 6e 20 74 68 65  t in between the
4530: 0a 53 45 4c 45 43 54 20 61 6e 64 20 46 52 4f 4d  .SELECT and FROM
4540: 20 6b 65 79 77 6f 72 64 73 2e 20 20 41 6e 79 20   keywords.  Any 
4550: 61 72 62 69 74 72 61 72 79 20 65 78 70 72 65 73  arbitrary expres
4560: 73 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64  sion can be used
4570: 0a 61 73 20 61 20 72 65 73 75 6c 74 2e 20 20 49  .as a result.  I
4580: 66 20 74 68 65 20 72 65 73 75 6c 74 20 73 70 65  f the result spe
4590: 63 69 66 69 63 61 74 69 6f 6e 20 69 73 20 6a 75  cification is ju
45a0: 73 74 7d 0a 70 75 74 73 20 22 5b 4f 70 65 72 61  st}.puts "[Opera
45b0: 74 6f 72 20 2a 5d 20 74 68 65 6e 20 61 6c 6c 20  tor *] then all 
45c0: 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6c 6c 20 74  columns of all t
45d0: 61 62 6c 65 73 20 61 72 65 20 75 73 65 64 20 61  ables are used a
45e0: 73 20 74 68 65 20 72 65 73 75 6c 74 2e 22 0a 70  s the result.".p
45f0: 75 74 73 20 7b 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  uts {</p>..<p>Th
4600: 65 20 71 75 65 72 79 20 69 73 20 65 78 65 63 75  e query is execu
4610: 74 65 64 20 61 67 61 69 6e 20 6f 6e 65 20 6f 72  ted again one or
4620: 20 6d 6f 72 65 20 74 61 62 6c 65 73 20 73 70 65   more tables spe
4630: 63 69 66 69 65 64 20 61 66 74 65 72 0a 74 68 65  cified after.the
4640: 20 46 52 4f 4d 20 6b 65 79 77 6f 72 64 2e 20 20   FROM keyword.  
4650: 49 66 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65  If more than one
4660: 20 74 61 62 6c 65 20 69 73 20 73 70 65 63 69 66   table is specif
4670: 69 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 71 75  ied, then the.qu
4680: 65 72 79 20 69 73 20 61 67 61 69 6e 73 74 20 74  ery is against t
4690: 68 65 20 6a 6f 69 6e 20 6f 66 20 74 68 65 20 76  he join of the v
46a0: 61 72 69 6f 75 73 20 74 61 62 6c 65 73 2e 3c 2f  arious tables.</
46b0: 70 3e 0a 0a 3c 70 3e 54 68 65 20 57 48 45 52 45  p>..<p>The WHERE
46c0: 20 63 6c 61 75 73 65 20 63 61 6e 20 62 65 20 75   clause can be u
46d0: 73 65 64 20 74 6f 20 6c 69 6d 69 74 20 74 68 65  sed to limit the
46e0: 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20   number of rows 
46f0: 6f 76 65 72 0a 77 68 69 63 68 20 74 68 65 20 71  over.which the q
4700: 75 65 72 79 20 6f 70 65 72 61 74 65 73 2e 20 20  uery operates.  
4710: 49 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 69  In the current i
4720: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 0a 69  mplementation,.i
4730: 6e 64 69 63 65 73 20 77 69 6c 6c 20 6f 6e 6c 79  ndices will only
4740: 20 62 65 20 75 73 65 64 20 74 6f 0a 6f 70 74 69   be used to.opti
4750: 6d 69 7a 65 20 74 68 65 20 71 75 65 72 79 20 69  mize the query i
4760: 66 20 57 48 45 52 45 20 65 78 70 72 65 73 73 69  f WHERE expressi
4770: 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 65 71 75 61  on contains equa
4780: 6c 69 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e 73  lity comparisons
4790: 0a 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68  .connected by th
47a0: 65 20 41 4e 44 20 6f 70 65 72 61 74 6f 72 2e 3c  e AND operator.<
47b0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47 52 4f 55  /p>..<p>The GROU
47c0: 50 20 42 59 20 63 6c 61 75 73 65 73 20 63 61 75  P BY clauses cau
47d0: 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20  ses one or more 
47e0: 72 6f 77 73 20 6f 66 20 74 68 65 20 72 65 73 75  rows of the resu
47f0: 6c 74 20 74 6f 0a 62 65 20 63 6f 6d 62 69 6e 65  lt to.be combine
4800: 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  d into a single 
4810: 72 6f 77 20 6f 66 20 6f 75 74 70 75 74 2e 20 20  row of output.  
4820: 54 68 69 73 20 69 73 20 65 73 70 65 63 69 61 6c  This is especial
4830: 6c 79 20 75 73 65 66 75 6c 0a 77 68 65 6e 20 74  ly useful.when t
4840: 68 65 20 72 65 73 75 6c 74 20 63 6f 6e 74 61 69  he result contai
4850: 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 75 6e  ns aggregate fun
4860: 63 74 69 6f 6e 73 2e 20 20 54 68 65 20 65 78 70  ctions.  The exp
4870: 72 65 73 73 69 6f 6e 73 20 69 6e 0a 74 68 65 20  ressions in.the 
4880: 47 52 4f 55 50 20 42 59 20 63 6c 61 75 73 65 20  GROUP BY clause 
4890: 64 6f 20 3c 65 6d 3e 6e 6f 74 3c 2f 65 6d 3e 20  do <em>not</em> 
48a0: 68 61 76 65 20 74 6f 20 62 65 20 65 78 70 72 65  have to be expre
48b0: 73 73 69 6f 6e 73 20 74 68 61 74 0a 61 70 70 65  ssions that.appe
48c0: 61 72 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74  ar in the result
48d0: 2e 20 20 54 68 65 20 48 41 56 49 4e 47 20 63 6c  .  The HAVING cl
48e0: 61 75 73 65 20 69 73 20 73 69 6d 69 6c 61 72 20  ause is similar 
48f0: 74 6f 20 57 48 45 52 45 20 65 78 63 65 70 74 0a  to WHERE except.
4900: 74 68 61 74 20 48 41 56 49 4e 47 20 61 70 70 6c  that HAVING appl
4910: 69 65 73 20 61 66 74 65 72 20 67 72 6f 75 70 69  ies after groupi
4920: 6e 67 20 68 61 73 20 6f 63 63 75 72 72 65 64 2e  ng has occurred.
4930: 20 20 54 68 65 20 48 41 56 49 4e 47 20 65 78 70    The HAVING exp
4940: 72 65 73 73 69 6f 6e 0a 6d 61 79 20 72 65 66 65  ression.may refe
4950: 72 20 74 6f 20 76 61 6c 75 65 73 2c 20 65 76 65  r to values, eve
4960: 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63  n aggregate func
4970: 74 69 6f 6e 73 2c 20 74 68 61 74 20 61 72 65 20  tions, that are 
4980: 6e 6f 74 20 69 6e 20 74 68 65 20 72 65 73 75 6c  not in the resul
4990: 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f  t.</p>..<p>The O
49a0: 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 63  RDER BY clause c
49b0: 61 75 73 65 73 20 74 68 65 20 6f 75 74 70 75 74  auses the output
49c0: 20 72 6f 77 73 20 74 6f 20 62 65 20 73 6f 72 74   rows to be sort
49d0: 65 64 2e 20 20 0a 54 68 65 20 61 72 67 75 6d 65  ed.  .The argume
49e0: 6e 74 20 74 6f 20 4f 52 44 45 52 20 42 59 20 69  nt to ORDER BY i
49f0: 73 20 61 20 6c 69 73 74 20 6f 66 20 65 78 70 72  s a list of expr
4a00: 65 73 73 69 6f 6e 73 20 74 68 61 74 20 61 72 65  essions that are
4a10: 20 75 73 65 64 20 61 73 20 74 68 65 0a 6b 65 79   used as the.key
4a20: 20 66 6f 72 20 74 68 65 20 73 6f 72 74 2e 20 20   for the sort.  
4a30: 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20  The expressions 
4a40: 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 62  do not have to b
4a50: 65 20 70 61 72 74 20 6f 66 20 74 68 65 0a 72 65  e part of the.re
4a60: 73 75 6c 74 20 66 6f 72 20 61 20 73 69 6d 70 6c  sult for a simpl
4a70: 65 20 53 45 4c 45 43 54 2c 20 62 75 74 20 69 6e  e SELECT, but in
4a80: 20 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45   a compound SELE
4a90: 43 54 20 65 61 63 68 20 73 6f 72 74 0a 65 78 70  CT each sort.exp
4aa0: 72 65 73 73 69 6f 6e 20 6d 75 73 74 20 65 78 61  ression must exa
4ab0: 63 74 6c 79 20 6d 61 74 63 68 20 6f 6e 65 20 6f  ctly match one o
4ac0: 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c  f the result col
4ad0: 75 6d 6e 73 2e 20 20 45 61 63 68 0a 73 6f 72 74  umns.  Each.sort
4ae0: 20 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 79 20   expression may 
4af0: 62 65 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 66 6f  be optionally fo
4b00: 6c 6c 6f 77 65 64 20 62 79 20 41 53 43 20 6f 72  llowed by ASC or
4b10: 20 44 45 53 43 20 74 6f 20 73 70 65 63 69 66 79   DESC to specify
4b20: 0a 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72 2e  .the sort order.
4b30: 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 63 6f 6d 70 6f  </p>..<p>A compo
4b40: 75 6e 64 20 53 45 4c 45 43 54 20 69 73 20 66 6f  und SELECT is fo
4b50: 72 6d 65 64 20 66 72 6f 6d 20 74 77 6f 20 6f 72  rmed from two or
4b60: 20 6d 6f 72 65 20 73 69 6d 70 6c 65 20 53 45 4c   more simple SEL
4b70: 45 43 54 73 20 63 6f 6e 6e 65 63 74 65 64 0a 62  ECTs connected.b
4b80: 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 6f 70 65  y one of the ope
4b90: 72 61 74 6f 72 73 20 55 4e 49 4f 4e 2c 20 55 4e  rators UNION, UN
4ba0: 49 4f 4e 20 41 4c 4c 2c 20 49 4e 54 45 52 53 45  ION ALL, INTERSE
4bb0: 43 54 2c 20 6f 72 20 45 58 43 45 50 54 2e 20 20  CT, or EXCEPT.  
4bc0: 49 6e 0a 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45  In.a compound SE
4bd0: 4c 45 43 54 2c 20 61 6c 6c 20 74 68 65 20 63 6f  LECT, all the co
4be0: 6e 73 74 69 74 75 65 6e 74 20 53 45 4c 45 43 54  nstituent SELECT
4bf0: 73 20 6d 75 73 74 20 73 70 65 63 69 66 79 20 74  s must specify t
4c00: 68 65 0a 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f  he.same number o
4c10: 66 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73  f result columns
4c20: 2e 20 20 54 68 65 72 65 20 6d 61 79 20 62 65 20  .  There may be 
4c30: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 4f 52  only a single OR
4c40: 44 45 52 20 42 59 0a 63 6c 61 75 73 65 20 61 74  DER BY.clause at
4c50: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20   the end of the 
4c60: 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e  compound SELECT.
4c70: 20 20 54 68 65 20 55 4e 49 4f 4e 20 61 6e 64 20    The UNION and 
4c80: 55 4e 49 4f 4e 20 41 4c 4c 0a 6f 70 65 72 61 74  UNION ALL.operat
4c90: 6f 72 73 20 63 6f 6d 62 69 6e 65 20 74 68 65 20  ors combine the 
4ca0: 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 53  results of the S
4cb0: 45 4c 45 43 54 73 20 74 6f 20 74 68 65 20 72 69  ELECTs to the ri
4cc0: 67 68 74 20 61 6e 64 20 6c 65 66 74 20 69 6e 74  ght and left int
4cd0: 6f 0a 61 20 73 69 6e 67 6c 65 20 62 69 67 20 74  o.a single big t
4ce0: 61 62 6c 65 2e 20 20 54 68 65 20 64 69 66 66 65  able.  The diffe
4cf0: 72 65 6e 63 65 20 69 73 20 74 68 61 74 20 69 6e  rence is that in
4d00: 20 55 4e 49 4f 4e 20 61 6c 6c 20 72 65 73 75 6c   UNION all resul
4d10: 74 20 72 6f 77 73 0a 61 72 65 20 64 69 73 74 69  t rows.are disti
4d20: 6e 63 74 20 77 68 65 72 65 20 69 6e 20 55 4e 49  nct where in UNI
4d30: 4f 4e 20 41 4c 4c 20 74 68 65 72 65 20 6d 61 79  ON ALL there may
4d40: 20 62 65 20 64 75 70 6c 69 63 61 74 65 73 2e 0a   be duplicates..
4d50: 54 68 65 20 49 4e 54 45 52 53 45 43 54 20 6f 70  The INTERSECT op
4d60: 65 72 61 74 6f 72 20 74 61 6b 65 73 20 74 68 65  erator takes the
4d70: 20 69 6e 74 65 72 73 65 63 74 69 6f 6e 20 6f 66   intersection of
4d80: 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20   the results of 
4d90: 74 68 65 0a 6c 65 66 74 20 61 6e 64 20 72 69 67  the.left and rig
4da0: 68 74 20 53 45 4c 45 43 54 73 2e 20 20 45 58 43  ht SELECTs.  EXC
4db0: 45 50 54 20 74 61 6b 65 73 20 74 68 65 20 72 65  EPT takes the re
4dc0: 73 75 6c 74 20 6f 66 20 6c 65 66 74 20 53 45 4c  sult of left SEL
4dd0: 45 43 54 20 61 66 74 65 72 0a 72 65 6d 6f 76 69  ECT after.removi
4de0: 6e 67 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f  ng the results o
4df0: 66 20 74 68 65 20 72 69 67 68 74 20 53 45 4c 45  f the right SELE
4e00: 43 54 2e 20 20 57 68 65 6e 20 74 68 72 65 65 20  CT.  When three 
4e10: 61 72 65 20 6d 6f 72 65 20 53 45 4c 45 43 54 73  are more SELECTs
4e20: 0a 61 72 65 20 63 6f 6e 6e 65 63 74 65 64 20 69  .are connected i
4e30: 6e 74 6f 20 61 20 63 6f 6d 70 6f 75 6e 64 2c 20  nto a compound, 
4e40: 74 68 65 79 20 67 72 6f 75 70 20 66 72 6f 6d 20  they group from 
4e50: 6c 65 66 74 20 74 6f 20 72 69 67 68 74 2e 3c 2f  left to right.</
4e60: 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 55 50  p>.}..Section UP
4e70: 44 41 54 45 20 75 70 64 61 74 65 0a 0a 53 79 6e  DATE update..Syn
4e80: 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65  tax {sql-stateme
4e90: 6e 74 7d 20 7b 0a 55 50 44 41 54 45 20 3c 74 61  nt} {.UPDATE <ta
4ea0: 62 6c 65 2d 6e 61 6d 65 3e 20 53 45 54 20 3c 61  ble-name> SET <a
4eb0: 73 73 69 67 6e 6d 65 6e 74 3e 20 5b 2c 20 3c 61  ssignment> [, <a
4ec0: 73 73 69 67 6e 6d 65 6e 74 3e 5d 20 5b 57 48 45  ssignment>] [WHE
4ed0: 52 45 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d  RE <expression>]
4ee0: 0a 7d 20 7b 61 73 73 69 67 6e 6d 65 6e 74 7d 20  .} {assignment} 
4ef0: 7b 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20  {.<column-name> 
4f00: 3d 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 0a 7d  = <expression>.}
4f10: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
4f20: 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74  UPDATE statement
4f30: 20 69 73 20 75 73 65 64 20 74 6f 20 63 68 61 6e   is used to chan
4f40: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
4f50: 63 6f 6c 75 6d 6e 73 20 69 6e 20 0a 73 65 6c 65  columns in .sele
4f60: 63 74 65 64 20 72 6f 77 73 20 6f 66 20 61 20 74  cted rows of a t
4f70: 61 62 6c 65 2e 20 20 45 61 63 68 20 61 73 73 69  able.  Each assi
4f80: 67 6e 6d 65 6e 74 20 69 6e 20 61 6e 20 55 50 44  gnment in an UPD
4f90: 41 54 45 20 73 70 65 63 69 66 69 65 73 0a 61 20  ATE specifies.a 
4fa0: 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 74 6f 20 74  column name to t
4fb0: 68 65 20 6c 65 66 74 20 6f 66 20 74 68 65 20 65  he left of the e
4fc0: 71 75 61 6c 73 20 73 69 67 6e 20 61 6e 64 20 61  quals sign and a
4fd0: 6e 20 61 72 62 69 74 72 61 72 79 20 65 78 70 72  n arbitrary expr
4fe0: 65 73 73 69 6f 6e 0a 74 6f 20 74 68 65 20 72 69  ession.to the ri
4ff0: 67 68 74 2e 20 20 54 68 65 20 65 78 70 72 65 73  ght.  The expres
5000: 73 69 6f 6e 73 20 6d 61 79 20 75 73 65 20 74 68  sions may use th
5010: 65 20 76 61 6c 75 65 73 20 6f 66 20 6f 74 68 65  e values of othe
5020: 72 20 63 6f 6c 75 6d 6e 73 2e 0a 41 6c 6c 20 65  r columns..All e
5030: 78 70 72 65 73 73 69 6f 6e 73 20 61 72 65 20 65  xpressions are e
5040: 76 61 6c 75 61 74 65 64 20 62 65 66 6f 72 65 20  valuated before 
5050: 61 6e 79 20 61 73 73 69 67 6e 6d 65 6e 74 73 20  any assignments 
5060: 61 72 65 20 6d 61 64 65 2e 0a 41 20 57 48 45 52  are made..A WHER
5070: 45 20 63 6c 61 75 73 65 20 63 61 6e 20 62 65 20  E clause can be 
5080: 75 73 65 64 20 74 6f 20 72 65 73 74 72 69 63 74  used to restrict
5090: 20 77 68 69 63 68 20 72 6f 77 73 20 61 72 65 20   which rows are 
50a0: 75 70 64 61 74 65 64 2e 0a 7d 0a 0a 53 65 63 74  updated..}..Sect
50b0: 69 6f 6e 20 56 41 43 55 55 4d 20 76 61 63 75 75  ion VACUUM vacuu
50c0: 6d 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  m..Syntax {sql-s
50d0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 56 41 43 55  tatement} {.VACU
50e0: 55 4d 20 5b 3c 69 6e 64 65 78 2d 6f 72 2d 74 61  UM [<index-or-ta
50f0: 62 6c 65 2d 6e 61 6d 65 3e 5d 0a 7d 0a 0a 70 75  ble-name>].}..pu
5100: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 56 41 43 55  ts {.<p>The VACU
5110: 55 4d 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e  UM command is an
5120: 20 53 51 4c 69 74 65 20 65 78 74 65 6e 73 69 6f   SQLite extensio
5130: 6e 20 6d 6f 64 65 6c 6c 65 64 20 61 66 74 65 72  n modelled after
5140: 20 61 20 73 69 6d 69 6c 61 72 0a 63 6f 6d 6d 61   a similar.comma
5150: 6e 64 20 66 6f 75 6e 64 20 69 6e 20 50 6f 73 74  nd found in Post
5160: 67 72 65 53 51 4c 2e 20 20 49 66 20 56 41 43 55  greSQL.  If VACU
5170: 55 4d 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 69  UM is invoked wi
5180: 74 68 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61  th the name of a
5190: 0a 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 20  .table or index 
51a0: 74 68 65 6e 20 69 74 20 69 73 20 73 75 70 70 6f  then it is suppo
51b0: 73 65 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 74  se to clean up t
51c0: 68 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 20 6f  he named table o
51d0: 72 20 69 6e 64 65 78 2e 0a 49 6e 20 76 65 72 73  r index..In vers
51e0: 69 6f 6e 20 31 2e 30 20 6f 66 20 53 51 4c 69 74  ion 1.0 of SQLit
51f0: 65 2c 20 74 68 65 20 56 41 43 55 55 4d 20 63 6f  e, the VACUUM co
5200: 6d 6d 61 6e 64 20 77 6f 75 6c 64 20 69 6e 76 6f  mmand would invo
5210: 6b 65 20 0a 3c 62 3e 67 64 62 6d 5f 72 65 6f 72  ke .<b>gdbm_reor
5220: 67 61 6e 69 7a 65 28 29 3c 2f 62 3e 20 74 6f 20  ganize()</b> to 
5230: 63 6c 65 61 6e 20 75 70 20 74 68 65 20 62 61 63  clean up the bac
5240: 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20 66 69  kend database fi
5250: 6c 65 2e 0a 42 65 67 69 6e 6e 69 6e 67 20 77 69  le..Beginning wi
5260: 74 68 20 76 65 72 73 69 6f 6e 20 32 2e 30 20 6f  th version 2.0 o
5270: 66 20 53 51 4c 69 74 65 2c 20 47 44 42 4d 20 69  f SQLite, GDBM i
5280: 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 73 65 64  s no longer used
5290: 20 66 6f 72 0a 74 68 65 20 64 61 74 61 62 61 73   for.the databas
52a0: 65 20 62 61 63 6b 65 6e 64 20 61 6e 64 20 56 41  e backend and VA
52b0: 43 55 55 4d 20 68 61 73 20 62 65 63 6f 6d 65 20  CUUM has become 
52c0: 61 20 6e 6f 2d 6f 70 2e 0a 3c 2f 70 3e 0a 7d 0a  a no-op..</p>.}.
52d0: 0a 53 65 63 74 69 6f 6e 20 50 52 41 47 4d 41 20  .Section PRAGMA 
52e0: 70 72 61 67 6d 61 0a 0a 53 79 6e 74 61 78 20 7b  pragma..Syntax {
52f0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
5300: 0a 50 52 41 47 4d 41 20 3c 6e 61 6d 65 3e 20 3d  .PRAGMA <name> =
5310: 20 3c 76 61 6c 75 65 3e 20 7c 0a 50 52 41 47 4d   <value> |.PRAGM
5320: 41 20 3c 66 75 6e 63 74 69 6f 6e 3e 28 3c 61 72  A <function>(<ar
5330: 67 3e 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  g>).}..puts {.<p
5340: 3e 54 68 65 20 50 52 41 47 4d 41 20 63 6f 6d 6d  >The PRAGMA comm
5350: 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 6d  and is used to m
5360: 6f 64 69 66 79 20 74 68 65 20 6f 70 65 72 61 74  odify the operat
5370: 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c 69 74  ion of the SQLit
5380: 65 20 6c 69 62 72 61 72 79 2e 0a 54 68 65 20 70  e library..The p
5390: 72 61 67 6d 61 20 63 6f 6d 6d 61 6e 64 20 69 73  ragma command is
53a0: 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 61 6e   experimental an
53b0: 64 20 73 70 65 63 69 66 69 63 20 70 72 61 67 6d  d specific pragm
53c0: 61 20 73 74 61 74 65 6d 65 6e 74 73 20 6d 61 79  a statements may
53d0: 0a 72 65 6d 6f 76 65 64 20 6f 72 20 61 64 64 65  .removed or adde
53e0: 64 20 69 6e 20 66 75 74 75 72 65 20 72 65 6c 65  d in future rele
53f0: 61 73 65 73 20 6f 66 20 53 51 4c 69 74 65 2e 20  ases of SQLite. 
5400: 20 55 73 65 20 74 68 69 73 20 63 6f 6d 6d 61 6e   Use this comman
5410: 64 0a 77 69 74 68 20 63 61 75 74 69 6f 6e 2e 3c  d.with caution.<
5420: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 75 72 72  /p>..<p>The curr
5430: 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ent implementati
5440: 6f 6e 20 73 75 70 70 6f 72 74 73 20 74 68 65 20  on supports the 
5450: 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 61 67 6d 61  following pragma
5460: 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69  s:</p>..<ul>.<li
5470: 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 63 61  ><p><b>PRAGMA ca
5480: 63 68 65 5f 73 69 7a 65 20 3d 20 3c 2f 62 3e 3c  che_size = </b><
5490: 69 3e 4e 75 6d 62 65 72 2d 6f 66 2d 70 61 67 65  i>Number-of-page
54a0: 73 3c 2f 69 3e 3c 62 3e 3b 3c 2f 62 3e 3c 2f 70  s</i><b>;</b></p
54b0: 3e 0a 20 20 20 20 3c 70 3e 43 68 61 6e 67 65 20  >.    <p>Change 
54c0: 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62  the maximum numb
54d0: 65 72 20 6f 66 20 64 61 74 61 62 61 73 65 20 64  er of database d
54e0: 69 73 6b 20 70 61 67 65 73 20 74 68 61 74 20 53  isk pages that S
54f0: 51 4c 69 74 65 0a 20 20 20 20 77 69 6c 6c 20 68  QLite.    will h
5500: 6f 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 61 74  old in memory at
5510: 20 6f 6e 63 65 2e 20 20 45 61 63 68 20 70 61 67   once.  Each pag
5520: 65 20 75 73 65 73 20 61 62 6f 75 74 20 31 2e 35  e uses about 1.5
5530: 4b 20 6f 66 20 52 41 4d 2e 0a 20 20 20 20 54 68  K of RAM..    Th
5540: 65 20 64 65 66 61 75 6c 74 20 63 61 63 68 65 20  e default cache 
5550: 73 69 7a 65 20 69 73 20 31 30 30 2e 20 20 49 66  size is 100.  If
5560: 20 79 6f 75 20 61 72 65 20 64 6f 69 6e 67 20 55   you are doing U
5570: 50 44 41 54 45 73 20 6f 72 20 44 45 4c 45 54 45  PDATEs or DELETE
5580: 73 0a 20 20 20 20 74 68 61 74 20 63 68 61 6e 67  s.    that chang
5590: 65 20 6d 61 6e 79 20 72 6f 77 73 20 6f 66 20 61  e many rows of a
55a0: 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 79 6f   database and yo
55b0: 75 20 64 6f 20 6e 6f 74 20 6d 69 6e 64 20 69 66  u do not mind if
55c0: 20 53 51 4c 69 74 65 0a 20 20 20 20 75 73 65 73   SQLite.    uses
55d0: 20 6d 6f 72 65 20 6d 65 6d 6f 72 79 2c 20 79 6f   more memory, yo
55e0: 75 20 63 61 6e 20 69 6e 63 72 65 61 73 65 20 74  u can increase t
55f0: 68 65 20 63 61 63 68 65 20 73 69 7a 65 20 66 6f  he cache size fo
5600: 72 20 61 20 70 6f 73 73 69 62 6c 65 20 73 70 65  r a possible spe
5610: 65 64 0a 20 20 20 20 69 6d 70 72 6f 76 65 6d 65  ed.    improveme
5620: 6e 74 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c  nt.</p></li>..<l
5630: 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 66  i><p><b>PRAGMA f
5640: 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 73  ull_column_names
5650: 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62   = ON;.       <b
5660: 72 3e 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f  r>PRAGMA full_co
5670: 6c 75 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 46 46  lumn_names = OFF
5680: 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70  ;</b></p>.    <p
5690: 3e 54 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65  >The column name
56a0: 73 20 72 65 70 6f 72 74 65 64 20 69 6e 20 61 6e  s reported in an
56b0: 20 53 51 4c 69 74 65 20 63 61 6c 6c 62 61 63 6b   SQLite callback
56c0: 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 6a 75   are normally ju
56d0: 73 74 0a 20 20 20 20 74 68 65 20 6e 61 6d 65 20  st.    the name 
56e0: 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 69 74  of the column it
56f0: 73 65 6c 66 2c 20 65 78 63 65 70 74 20 66 6f 72  self, except for
5700: 20 6a 6f 69 6e 73 20 77 68 65 6e 20 22 54 41 42   joins when "TAB
5710: 4c 45 2e 43 4f 4c 55 4d 4e 22 0a 20 20 20 20 69  LE.COLUMN".    i
5720: 73 20 75 73 65 64 2e 20 20 42 75 74 20 77 68 65  s used.  But whe
5730: 6e 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61  n full_column_na
5740: 6d 65 73 20 69 73 20 74 75 72 6e 65 64 20 6f 6e  mes is turned on
5750: 2c 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 61  , column names a
5760: 72 65 0a 20 20 20 20 61 6c 77 61 79 73 20 72 65  re.    always re
5770: 70 6f 72 74 65 64 20 61 73 20 22 54 41 42 4c 45  ported as "TABLE
5780: 2e 43 4f 4c 55 4d 4e 22 20 65 76 65 6e 20 66 6f  .COLUMN" even fo
5790: 72 20 73 69 6d 70 6c 65 20 71 75 65 72 69 65 73  r simple queries
57a0: 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e  .</p></li>..<li>
57b0: 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 76 64 62  <p><b>PRAGMA vdb
57c0: 65 5f 74 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72  e_trace = ON;<br
57d0: 3e 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61  >PRAGMA vdbe_tra
57e0: 63 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70  ce = OFF;</b></p
57f0: 3e 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72  >.    <p>Turn tr
5800: 61 63 69 6e 67 20 6f 66 20 74 68 65 20 76 69 72  acing of the vir
5810: 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 65 6e  tual database en
5820: 67 69 6e 65 20 69 6e 73 69 64 65 20 6f 66 20 74  gine inside of t
5830: 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c 69  he.    SQLite li
5840: 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66 66  brary on and off
5850: 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20  .  This is used 
5860: 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 3c 2f  for debugging.</
5870: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
5880: 3c 62 3e 50 52 41 47 4d 41 20 70 61 72 73 65 72  <b>PRAGMA parser
5890: 5f 74 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e  _trace = ON;<br>
58a0: 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72  PRAGMA parser_tr
58b0: 61 63 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f  ace = OFF;</b></
58c0: 70 3e 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74  p>.    <p>Turn t
58d0: 72 61 63 69 6e 67 20 6f 66 20 74 68 65 20 53 51  racing of the SQ
58e0: 4c 20 70 61 72 73 65 72 20 69 6e 73 69 64 65 20  L parser inside 
58f0: 6f 66 20 74 68 65 0a 20 20 20 20 53 51 4c 69 74  of the.    SQLit
5900: 65 20 6c 69 62 72 61 72 79 20 6f 6e 20 61 6e 64  e library on and
5910: 20 6f 66 66 2e 20 20 54 68 69 73 20 69 73 20 75   off.  This is u
5920: 73 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e  sed for debuggin
5930: 67 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 75 6c  g.</p></li>.</ul
5940: 3e 0a 0a 3c 70 3e 4e 6f 20 65 72 72 6f 72 20 6d  >..<p>No error m
5950: 65 73 73 61 67 65 20 69 73 20 67 65 6e 65 72 61  essage is genera
5960: 74 65 64 20 69 66 20 61 6e 20 75 6e 6b 6e 6f 77  ted if an unknow
5970: 6e 20 70 72 61 67 6d 61 20 69 73 20 69 73 73 75  n pragma is issu
5980: 65 64 2e 0a 55 6e 6b 6e 6f 77 6e 20 70 72 61 67  ed..Unknown prag
5990: 6d 61 73 20 61 72 65 20 69 67 6e 6f 72 65 64 2e  mas are ignored.
59a0: 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  </p>.}..puts {.<
59b0: 70 3e 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b  p></p>.}..puts {
59c0: 0a 3c 70 3e 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c  .<p><hr /></p>.<
59d0: 70 3e 3c 61 20 68 72 65 66 3d 22 69 6e 64 65 78  p><a href="index
59e0: 2e 68 74 6d 6c 22 3e 3c 69 6d 67 20 73 72 63 3d  .html"><img src=
59f0: 22 2f 67 6f 62 61 63 6b 2e 6a 70 67 22 20 62 6f  "/goback.jpg" bo
5a00: 72 64 65 72 3d 30 20 2f 3e 0a 42 61 63 6b 20 74  rder=0 />.Back t
5a10: 6f 20 74 68 65 20 53 51 4c 69 74 65 20 48 6f 6d  o the SQLite Hom
5a20: 65 20 50 61 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a  e Page</a>.</p>.
5a30: 0a 3c 2f 62 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d  .</body></html>}
5a40: 0a                                               .