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

Artifact f0e953bfeaaba4c33117ec4bca639dd71ba0e13e:


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 35 20 32 30 30 31  .tcl,v 1.15 2001
0060: 2f 31 31 2f 30 36 20 31 34 3a 31 30 3a 34 32 20  /11/06 14:10:42 
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 20 20 20 20 25 0a 2b 20 20 20 20 2d 0a 26   /    %.+    -.&
2d30: 6c 74 3b 26 6c 74 3b 20 20 20 26 67 74 3b 26 67  lt;&lt;   &gt;&g
2d40: 74 3b 20 20 20 26 61 6d 70 3b 20 20 20 20 7c 0a  t;   &amp;    |.
2d50: 26 6c 74 3b 20 20 20 20 26 6c 74 3b 3d 20 20 20  &lt;    &lt;=   
2d60: 26 67 74 3b 20 20 20 20 26 67 74 3b 3d 0a 3d 20  &gt;    &gt;=.= 
2d70: 20 20 20 3d 3d 20 20 20 21 3d 20 20 20 26 6c 74     ==   !=   &lt
2d80: 3b 26 67 74 3b 20 20 20 3c 2f 62 69 67 3e 49 4e  ;&gt;   </big>IN
2d90: 0a 41 4e 44 0a 4f 52 3c 2f 66 6f 6e 74 3e 0a 3c  .AND.OR</font>.<
2da0: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
2db0: 65 3e 0a 0a 3c 70 3e 53 75 70 70 6f 72 74 65 64  e>..<p>Supported
2dc0: 20 75 6e 61 72 79 20 6f 70 65 72 61 74 65 72 73   unary operaters
2dd0: 20 61 72 65 20 74 68 65 73 65 3a 3c 2f 70 3e 0a   are these:</p>.
2de0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
2df0: 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22  e>.<font color="
2e00: 23 32 63 32 63 66 30 22 3e 3c 62 69 67 3e 2d 20  #2c2cf0"><big>- 
2e10: 20 20 20 2b 20 20 20 20 21 20 20 20 20 7e 3c 2f     +    !    ~</
2e20: 62 69 67 3e 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72  big></font>.</pr
2e30: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
2e40: 0a 3c 70 3e 41 6e 79 20 53 51 4c 69 74 65 20 76  .<p>Any SQLite v
2e50: 61 6c 75 65 20 63 61 6e 20 62 65 20 75 73 65 64  alue can be used
2e60: 20 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 65   as part of an e
2e70: 78 70 72 65 73 73 69 6f 6e 2e 20 20 0a 46 6f 72  xpression.  .For
2e80: 20 61 72 69 74 68 6d 65 74 69 63 20 6f 70 65 72   arithmetic oper
2e90: 61 74 69 6f 6e 73 2c 20 69 6e 74 65 67 65 72 73  ations, integers
2ea0: 20 61 72 65 20 74 72 65 61 74 65 64 20 61 73 20   are treated as 
2eb0: 69 6e 74 65 67 65 72 73 2e 0a 53 74 72 69 6e 67  integers..String
2ec0: 73 20 61 72 65 20 66 69 72 73 74 20 63 6f 6e 76  s are first conv
2ed0: 65 72 74 65 64 20 74 6f 20 72 65 61 6c 20 6e 75  erted to real nu
2ee0: 6d 62 65 72 73 20 75 73 69 6e 67 20 3c 62 3e 61  mbers using <b>a
2ef0: 74 6f 66 28 29 3c 2f 62 3e 2e 0a 46 6f 72 20 63  tof()</b>..For c
2f00: 6f 6d 70 61 72 69 73 6f 6e 20 6f 70 65 72 61 74  omparison operat
2f10: 6f 72 73 2c 20 6e 75 6d 62 65 72 73 20 63 6f 6d  ors, numbers com
2f20: 70 61 72 65 20 61 73 20 6e 75 6d 62 65 72 73 20  pare as numbers 
2f30: 61 6e 64 20 73 74 72 69 6e 67 73 0a 63 6f 6d 70  and strings.comp
2f40: 61 72 65 20 61 73 20 73 74 72 69 6e 67 73 2e 20  are as strings. 
2f50: 20 46 6f 72 20 73 74 72 69 6e 67 20 63 6f 6d 70   For string comp
2f60: 61 72 69 73 6f 6e 73 2c 20 63 61 73 65 20 69 73  arisons, case is
2f70: 20 73 69 67 6e 69 66 69 63 61 6e 74 0a 62 75 74   significant.but
2f80: 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f   is only used to
2f90: 20 62 72 65 61 6b 20 61 20 74 69 65 2e 0a 4e 6f   break a tie..No
2fa0: 74 65 20 74 68 61 74 20 74 68 65 72 65 20 61 72  te that there ar
2fb0: 65 20 74 77 6f 20 76 61 72 69 61 74 69 6f 6e 73  e two variations
2fc0: 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73 20 61   of the equals a
2fd0: 6e 64 20 6e 6f 74 20 65 71 75 61 6c 73 0a 6f 70  nd not equals.op
2fe0: 65 72 61 74 6f 72 73 2e 20 20 45 71 75 61 6c 73  erators.  Equals
2ff0: 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 7d 0a   can be either}.
3000: 70 75 74 73 20 22 5b 4f 70 65 72 61 74 6f 72 20  puts "[Operator 
3010: 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74 6f 72 20  =] or [Operator 
3020: 3d 3d 5d 2e 0a 54 68 65 20 6e 6f 6e 2d 65 71 75  ==]..The non-equ
3030: 61 6c 73 20 6f 70 65 72 61 74 6f 72 20 63 61 6e  als operator can
3040: 20 62 65 20 65 69 74 68 65 72 0a 5b 4f 70 65 72   be either.[Oper
3050: 61 74 6f 72 20 21 3d 5d 20 6f 72 20 5b 4f 70 65  ator !=] or [Ope
3060: 72 61 74 6f 72 20 7b 26 6c 74 3b 26 67 74 3b 7d  rator {&lt;&gt;}
3070: 5d 2e 3c 2f 70 3e 22 0a 70 75 74 73 20 7b 0a 0a  ].</p>".puts {..
3080: 3c 70 3e 54 68 65 20 4c 49 4b 45 20 6f 70 65 72  <p>The LIKE oper
3090: 61 74 6f 72 20 64 6f 65 73 20 61 20 77 69 6c 64  ator does a wild
30a0: 63 61 72 64 20 63 6f 6d 70 61 72 69 73 69 6f 6e  card comparision
30b0: 2e 20 20 54 68 65 20 6f 70 65 72 61 6e 64 0a 74  .  The operand.t
30c0: 6f 20 74 68 65 20 72 69 67 68 74 20 63 6f 6e 74  o the right cont
30d0: 61 69 6e 73 20 74 68 65 20 77 69 6c 64 63 61 72  ains the wildcar
30e0: 64 73 2e 7d 0a 70 75 74 73 20 22 41 20 70 65 72  ds.}.puts "A per
30f0: 63 65 6e 74 20 73 79 6d 62 6f 6c 20 5b 4f 70 65  cent symbol [Ope
3100: 72 61 74 6f 72 20 25 5d 20 69 6e 20 74 68 65 20  rator %] in the 
3110: 72 69 67 68 74 20 6f 70 65 72 61 6e 64 0a 6d 61  right operand.ma
3120: 74 63 68 65 73 20 61 6e 79 20 73 65 71 75 65 6e  tches any sequen
3130: 63 65 20 6f 66 20 7a 65 72 6f 20 6f 72 20 6d 6f  ce of zero or mo
3140: 72 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e  re characters on
3150: 20 74 68 65 20 6c 65 66 74 2e 0a 41 6e 20 75 6e   the left..An un
3160: 64 65 72 73 63 6f 72 65 20 5b 4f 70 65 72 61 74  derscore [Operat
3170: 6f 72 20 5f 5d 20 6f 6e 20 74 68 65 20 72 69 67  or _] on the rig
3180: 68 74 0a 6d 61 74 63 68 65 73 20 61 6e 79 20 73  ht.matches any s
3190: 69 6e 67 6c 65 20 63 68 61 72 61 63 74 65 72 20  ingle character 
31a0: 6f 6e 20 74 68 65 20 6c 65 66 74 2e 22 0a 70 75  on the left.".pu
31b0: 74 73 20 7b 54 68 65 20 4c 49 4b 45 20 6f 70 65  ts {The LIKE ope
31c0: 72 61 74 6f 72 20 69 73 0a 6e 6f 74 20 63 61 73  rator is.not cas
31d0: 65 20 73 65 6e 73 69 74 69 76 65 20 61 6e 64 20  e sensitive and 
31e0: 77 69 6c 6c 20 6d 61 74 63 68 20 75 70 70 65 72  will match upper
31f0: 20 63 61 73 65 20 63 68 61 72 61 63 74 65 72 73   case characters
3200: 20 6f 6e 20 6f 6e 65 0a 73 69 64 65 20 61 67 61   on one.side aga
3210: 69 6e 73 74 20 6c 6f 77 65 72 20 63 61 73 65 20  inst lower case 
3220: 63 68 61 72 61 63 74 65 72 73 20 6f 6e 20 74 68  characters on th
3230: 65 20 6f 74 68 65 72 2e 0a 28 41 20 62 75 67 3a  e other..(A bug:
3240: 20 53 51 4c 69 74 65 20 6f 6e 6c 79 20 75 6e 64   SQLite only und
3250: 65 72 73 74 61 6e 64 73 20 75 70 70 65 72 2f 6c  erstands upper/l
3260: 6f 77 65 72 20 63 61 73 65 20 66 6f 72 20 37 2d  ower case for 7-
3270: 62 69 74 20 4c 61 74 69 6e 0a 63 68 61 72 61 63  bit Latin.charac
3280: 74 65 72 73 2e 20 20 48 65 6e 63 65 20 74 68 65  ters.  Hence the
3290: 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72 20 69   LIKE operator i
32a0: 73 20 63 61 73 65 20 73 65 6e 73 69 74 69 76 65  s case sensitive
32b0: 20 66 6f 72 0a 38 2d 62 69 74 20 69 73 6f 38 38   for.8-bit iso88
32c0: 35 39 20 63 68 61 72 61 63 74 65 72 73 20 6f 72  59 characters or
32d0: 20 55 54 46 2d 38 20 63 68 61 72 61 63 74 65 72   UTF-8 character
32e0: 73 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c  s.  For example,
32f0: 0a 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20  .the expression 
3300: 3c 62 3e 27 61 27 26 6e 62 73 70 3b 4c 49 4b 45  <b>'a'&nbsp;LIKE
3310: 26 6e 62 73 70 3b 27 41 27 3c 2f 62 3e 20 69 73  &nbsp;'A'</b> is
3320: 20 54 52 55 45 20 62 75 74 0a 3c 62 3e 27 26 61   TRUE but.<b>'&a
3330: 65 6c 69 67 3b 27 26 6e 62 73 70 3b 4c 49 4b 45  elig;'&nbsp;LIKE
3340: 26 6e 62 73 70 3b 27 26 41 45 6c 69 67 3b 27 3c  &nbsp;'&AElig;'<
3350: 2f 62 3e 20 69 73 20 46 41 4c 53 45 2e 29 0a 3c  /b> is FALSE.).<
3360: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47 4c 4f 42  /p>..<p>The GLOB
3370: 20 6f 70 65 72 61 74 6f 72 20 69 73 20 73 69 6d   operator is sim
3380: 69 6c 61 72 20 74 6f 20 4c 49 4b 45 20 62 75 74  ilar to LIKE but
3390: 20 75 73 65 73 20 74 68 65 20 55 6e 69 78 0a 66   uses the Unix.f
33a0: 69 6c 65 20 67 6c 6f 62 62 69 6e 67 20 73 79 6e  ile globbing syn
33b0: 74 61 78 20 66 6f 72 20 69 74 73 20 77 69 6c 64  tax for its wild
33c0: 63 61 72 64 73 2e 20 20 41 6c 73 6f 2c 20 47 4c  cards.  Also, GL
33d0: 4f 42 20 69 73 20 63 61 73 65 0a 73 65 6e 73 69  OB is case.sensi
33e0: 74 69 76 65 2c 20 75 6e 6c 69 6b 65 20 4c 49 4b  tive, unlike LIK
33f0: 45 2e 20 20 42 6f 74 68 20 47 4c 4f 42 20 61 6e  E.  Both GLOB an
3400: 64 20 4c 49 4b 45 20 6d 61 79 20 62 65 20 70 72  d LIKE may be pr
3410: 65 63 65 64 65 64 20 62 79 0a 74 68 65 20 4e 4f  eceded by.the NO
3420: 54 20 6b 65 79 77 6f 72 64 20 74 6f 20 69 6e 76  T keyword to inv
3430: 65 72 74 20 74 68 65 20 73 65 6e 73 65 20 6f 66  ert the sense of
3440: 20 74 68 65 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a   the test.</p>..
3450: 3c 70 3e 41 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65  <p>A column name
3460: 20 63 61 6e 20 62 65 20 61 6e 79 20 6f 66 20 74   can be any of t
3470: 68 65 20 6e 61 6d 65 73 20 64 65 66 69 6e 65 64  he names defined
3480: 20 69 6e 20 74 68 65 20 43 52 45 41 54 45 20 54   in the CREATE T
3490: 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e 74 20 6f  ABLE.statement o
34a0: 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c  r one of the fol
34b0: 6c 6f 77 69 6e 67 20 73 70 65 63 69 61 6c 20 69  lowing special i
34c0: 64 65 6e 74 69 66 69 65 72 73 3a 20 22 3c 62 3e  dentifiers: "<b>
34d0: 52 4f 57 49 44 3c 2f 62 3e 22 2c 0a 22 3c 62 3e  ROWID</b>",."<b>
34e0: 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20 22 3c 62  OID</b>", or "<b
34f0: 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54  >_ROWID_</b>"..T
3500: 68 65 73 65 20 73 70 65 63 69 61 6c 20 69 64 65  hese special ide
3510: 6e 74 69 66 69 65 72 73 20 61 6c 6c 20 64 65 73  ntifiers all des
3520: 63 72 69 62 65 20 74 68 65 0a 75 6e 69 71 75 65  cribe the.unique
3530: 20 72 61 6e 64 6f 6d 20 69 6e 74 65 67 65 72 20   random integer 
3540: 6b 65 79 20 28 74 68 65 20 22 72 6f 77 20 6b 65  key (the "row ke
3550: 79 22 29 20 61 73 73 6f 63 69 61 74 65 64 20 77  y") associated w
3560: 69 74 68 20 65 76 65 72 79 20 0a 72 6f 77 20 6f  ith every .row o
3570: 66 20 65 76 65 72 79 20 74 61 62 6c 65 2e 0a 54  f every table..T
3580: 68 65 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74  he special ident
3590: 69 66 69 65 72 73 20 6f 6e 6c 79 20 72 65 66 65  ifiers only refe
35a0: 72 20 74 6f 20 74 68 65 20 72 6f 77 20 6b 65 79  r to the row key
35b0: 20 69 66 20 74 68 65 20 43 52 45 41 54 45 20 54   if the CREATE T
35c0: 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e 74 20 64  ABLE.statement d
35d0: 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 20 61  oes not define a
35e0: 20 72 65 61 6c 20 63 6f 6c 75 6d 6e 20 77 69 74   real column wit
35f0: 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 2e  h the same name.
3600: 20 20 52 6f 77 20 6b 65 79 73 0a 61 63 74 20 6c    Row keys.act l
3610: 69 6b 65 20 72 65 61 64 2d 6f 6e 6c 79 20 63 6f  ike read-only co
3620: 6c 75 6d 6e 73 2e 20 20 41 20 72 6f 77 20 6b 65  lumns.  A row ke
3630: 79 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 6e  y can be used an
3640: 79 77 68 65 72 65 20 61 20 72 65 67 75 6c 61 72  ywhere a regular
3650: 0a 63 6f 6c 75 6d 6e 20 63 61 6e 20 62 65 20 75  .column can be u
3660: 73 65 64 2c 20 65 78 63 65 70 74 20 74 68 61 74  sed, except that
3670: 20 79 6f 75 20 63 61 6e 6e 6f 74 20 63 68 61 6e   you cannot chan
3680: 67 65 20 74 68 65 20 76 61 6c 75 65 0a 6f 66 20  ge the value.of 
3690: 61 20 72 6f 77 20 6b 65 79 20 69 6e 20 61 6e 20  a row key in an 
36a0: 55 50 44 41 54 45 20 6f 72 20 49 4e 53 45 52 54  UPDATE or INSERT
36b0: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 22 53 45 4c   statement.."SEL
36c0: 45 43 54 20 2a 20 2e 2e 2e 22 20 64 6f 65 73 20  ECT * ..." does 
36d0: 6e 6f 74 20 72 65 74 75 72 6e 20 74 68 65 20 72  not return the r
36e0: 6f 77 20 6b 65 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e  ow key.</p>..<p>
36f0: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74  SELECT statement
3700: 73 20 63 61 6e 20 61 70 70 65 61 72 20 69 6e 20  s can appear in 
3710: 65 78 70 72 65 73 73 69 6f 6e 73 20 61 73 20 65  expressions as e
3720: 69 74 68 65 72 20 74 68 65 0a 72 69 67 68 74 2d  ither the.right-
3730: 68 61 6e 64 20 6f 70 65 72 61 6e 64 20 6f 66 20  hand operand of 
3740: 74 68 65 20 49 4e 20 6f 70 65 72 61 74 6f 72 20  the IN operator 
3750: 6f 72 20 61 73 20 61 20 73 63 61 6c 61 72 20 71  or as a scalar q
3760: 75 61 6e 74 69 74 79 2e 0a 49 6e 20 62 6f 74 68  uantity..In both
3770: 20 63 61 73 65 73 2c 20 74 68 65 20 53 45 4c 45   cases, the SELE
3780: 43 54 20 73 68 6f 75 6c 64 20 68 61 76 65 20 6f  CT should have o
3790: 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c  nly a single col
37a0: 75 6d 6e 20 69 6e 20 69 74 73 0a 72 65 73 75 6c  umn in its.resul
37b0: 74 2e 20 20 43 6f 6d 70 6f 75 6e 64 20 53 45 4c  t.  Compound SEL
37c0: 45 43 54 73 20 28 63 6f 6e 6e 65 63 74 65 64 20  ECTs (connected 
37d0: 77 69 74 68 20 6b 65 79 77 6f 72 64 73 20 6c 69  with keywords li
37e0: 6b 65 20 55 4e 49 4f 4e 20 6f 72 0a 45 58 43 45  ke UNION or.EXCE
37f0: 50 54 29 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e  PT) are allowed.
3800: 20 20 41 6e 79 20 4f 52 44 45 52 20 42 59 20 63    Any ORDER BY c
3810: 6c 61 75 73 65 20 6f 6e 20 74 68 65 20 73 65 6c  lause on the sel
3820: 65 63 74 20 69 73 20 69 67 6e 6f 72 65 64 2e 0a  ect is ignored..
3830: 41 20 53 45 4c 45 43 54 20 69 6e 20 61 6e 20 65  A SELECT in an e
3840: 78 70 72 65 73 73 69 6f 6e 20 69 73 20 65 76 61  xpression is eva
3850: 6c 75 61 74 65 64 20 6f 6e 63 65 20 62 65 66 6f  luated once befo
3860: 72 65 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f  re any other pro
3870: 63 65 73 73 69 6e 67 0a 69 73 20 70 65 72 66 6f  cessing.is perfo
3880: 72 6d 65 64 2c 20 73 6f 20 6e 6f 6e 65 20 6f 66  rmed, so none of
3890: 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73   the expressions
38a0: 20 77 69 74 68 69 6e 20 74 68 65 20 73 65 6c 65   within the sele
38b0: 63 74 20 69 74 73 65 6c 66 20 63 61 6e 0a 72 65  ct itself can.re
38c0: 66 65 72 20 74 6f 20 71 75 61 6e 74 69 74 69 65  fer to quantitie
38d0: 73 20 69 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e  s in the contain
38e0: 69 6e 67 20 65 78 70 72 65 73 73 69 6f 6e 2e 3c  ing expression.<
38f0: 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53  /p>..<p>When a S
3900: 45 4c 45 43 54 20 69 73 20 74 68 65 20 72 69 67  ELECT is the rig
3910: 68 74 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68  ht operand of th
3920: 65 20 49 4e 20 6f 70 65 72 61 74 6f 72 2c 20 74  e IN operator, t
3930: 68 65 20 49 4e 0a 6f 70 65 72 61 74 6f 72 20 72  he IN.operator r
3940: 65 74 75 72 6e 73 20 54 52 55 45 20 69 66 20 74  eturns TRUE if t
3950: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65  he result of the
3960: 20 6c 65 66 74 20 6f 70 65 72 61 6e 64 20 69 73   left operand is
3970: 20 61 6e 79 20 6f 66 0a 74 68 65 20 76 61 6c 75   any of.the valu
3980: 65 73 20 67 65 6e 65 72 61 74 65 64 20 62 79 20  es generated by 
3990: 74 68 65 20 73 65 6c 65 63 74 2e 20 20 54 68 65  the select.  The
39a0: 20 49 4e 20 6f 70 65 72 61 74 6f 72 20 6d 61 79   IN operator may
39b0: 20 62 65 20 70 72 65 63 65 64 65 64 0a 62 79 20   be preceded.by 
39c0: 74 68 65 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20  the NOT keyword 
39d0: 74 6f 20 69 6e 76 65 72 74 20 74 68 65 20 73 65  to invert the se
39e0: 6e 73 65 20 6f 66 20 74 68 65 20 74 65 73 74 2e  nse of the test.
39f0: 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20  </p>..<p>When a 
3a00: 53 45 4c 45 43 54 20 61 70 70 65 61 72 73 20 77  SELECT appears w
3a10: 69 74 68 69 6e 20 61 6e 20 65 78 70 72 65 73 73  ithin an express
3a20: 69 6f 6e 20 62 75 74 20 69 73 20 6e 6f 74 20 74  ion but is not t
3a30: 68 65 20 72 69 67 68 74 0a 6f 70 65 72 61 6e 64  he right.operand
3a40: 20 6f 66 20 61 6e 20 49 4e 20 6f 70 65 72 61 74   of an IN operat
3a50: 6f 72 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72  or, then the fir
3a60: 73 74 20 72 6f 77 20 6f 66 20 74 68 65 20 72 65  st row of the re
3a70: 73 75 6c 74 20 6f 66 20 74 68 65 0a 53 45 4c 45  sult of the.SELE
3a80: 43 54 20 62 65 63 6f 6d 65 73 20 74 68 65 20 76  CT becomes the v
3a90: 61 6c 75 65 20 75 73 65 64 20 69 6e 20 74 68 65  alue used in the
3aa0: 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 49 66   expression.  If
3ab0: 20 74 68 65 20 53 45 4c 45 43 54 20 79 69 65 6c   the SELECT yiel
3ac0: 64 73 0a 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65  ds.more than one
3ad0: 20 72 65 73 75 6c 74 20 72 6f 77 2c 20 61 6c 6c   result row, all
3ae0: 20 72 6f 77 73 20 61 66 74 65 72 20 74 68 65 20   rows after the 
3af0: 66 69 72 73 74 20 61 72 65 20 69 67 6e 6f 72 65  first are ignore
3b00: 64 2e 20 20 49 66 0a 74 68 65 20 53 45 4c 45 43  d.  If.the SELEC
3b10: 54 20 79 65 69 6c 64 73 20 6e 6f 20 72 6f 77 73  T yeilds no rows
3b20: 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65  , then the value
3b30: 20 6f 66 20 74 68 65 20 53 45 4c 45 43 54 20 69   of the SELECT i
3b40: 73 20 4e 55 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e  s NULL.</p>..<p>
3b50: 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 73  The expression s
3b60: 79 6e 74 61 78 20 63 75 72 72 65 6e 74 6c 79 20  yntax currently 
3b70: 73 75 70 70 6f 72 74 73 20 74 68 65 20 66 6f 6c  supports the fol
3b80: 6c 6f 77 69 6e 67 0a 66 75 6e 63 74 69 6f 6e 73  lowing.functions
3b90: 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f  :</p>..<blockquo
3ba0: 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e 74 20 63  te><pre>.<font c
3bb0: 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e 3c  olor="#2c2cf0"><
3bc0: 62 69 67 3e 63 6f 75 6e 74 20 20 20 20 6d 69 6e  big>count    min
3bd0: 20 20 20 20 20 20 20 6d 61 78 20 20 20 20 20 20         max      
3be0: 20 73 75 6d 0a 61 76 67 20 20 20 20 20 20 6c 65   sum.avg      le
3bf0: 6e 67 74 68 20 20 20 20 73 75 62 73 74 72 20 20  ngth    substr  
3c00: 20 20 61 62 73 20 20 20 20 20 20 20 72 6f 75 6e    abs       roun
3c10: 64 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74 3e 0a 3c  d</big></font>.<
3c20: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
3c30: 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66 75 6e 63  e>..<p>.The func
3c40: 74 69 6f 6e 73 20 3c 62 3e 63 6f 75 6e 74 3c 2f  tions <b>count</
3c50: 62 3e 2c 20 3c 62 3e 73 75 6d 3c 2f 62 3e 2c 20  b>, <b>sum</b>, 
3c60: 61 6e 64 20 3c 62 3e 61 76 67 3c 2f 62 3e 20 61  and <b>avg</b> a
3c70: 6e 64 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 73  nd the functions
3c80: 0a 3c 62 3e 6d 69 6e 3c 2f 62 3e 20 61 6e 64 20  .<b>min</b> and 
3c90: 3c 62 3e 6d 61 78 3c 2f 62 3e 20 75 73 65 64 20  <b>max</b> used 
3ca0: 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 20 61 72  with only one ar
3cb0: 67 75 6d 65 6e 74 20 61 72 65 20 61 6c 6c 20 61  gument are all a
3cc0: 67 67 72 65 67 61 74 65 0a 66 75 6e 63 74 69 6f  ggregate.functio
3cd0: 6e 73 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20  ns.  This means 
3ce0: 74 68 61 74 20 74 68 65 79 20 61 72 65 20 63 6f  that they are co
3cf0: 6d 70 75 74 65 64 20 61 63 72 6f 73 73 20 61 6c  mputed across al
3d00: 6c 20 72 6f 77 73 20 6f 66 20 74 68 65 20 72 65  l rows of the re
3d10: 73 75 6c 74 2e 0a 54 68 65 20 66 75 6e 63 74 69  sult..The functi
3d20: 6f 6e 73 20 3c 62 3e 6d 69 6e 3c 2f 62 3e 20 61  ons <b>min</b> a
3d30: 6e 64 20 3c 62 3e 6d 61 78 3c 2f 62 3e 0a 77 69  nd <b>max</b>.wi
3d40: 74 68 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 61  th two or more a
3d50: 72 67 75 6d 65 6e 74 73 20 61 6e 64 20 61 6c 6c  rguments and all
3d60: 20 6f 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 73   other functions
3d70: 0a 61 72 65 20 6e 6f 6e 2d 61 67 67 72 65 67 61  .are non-aggrega
3d80: 74 65 73 2e 20 20 4e 6f 6e 2d 61 67 67 72 65 67  tes.  Non-aggreg
3d90: 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 0a 61 72  ate functions.ar
3da0: 65 20 63 6f 6d 70 75 74 65 64 20 73 65 70 61 72  e computed separ
3db0: 61 74 65 6c 79 20 66 6f 72 20 65 61 63 68 20 72  ately for each r
3dc0: 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ow of the result
3dd0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20  ..</p>..<p>.The 
3de0: 3c 62 3e 72 6f 75 6e 64 3c 2f 62 3e 20 66 75 6e  <b>round</b> fun
3df0: 63 74 69 6f 6e 20 63 61 6e 20 74 61 6b 65 20 65  ction can take e
3e00: 69 74 68 65 72 20 31 20 6f 72 20 32 20 61 72 67  ither 1 or 2 arg
3e10: 75 6d 65 6e 74 73 2e 20 20 54 68 65 0a 66 69 72  uments.  The.fir
3e20: 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74  st argument is t
3e30: 68 65 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e  he floating poin
3e40: 74 20 76 61 6c 75 65 20 74 68 61 74 20 69 73 20  t value that is 
3e50: 72 6f 75 6e 64 65 64 2e 20 20 54 68 65 0a 73 65  rounded.  The.se
3e60: 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73  cond argument is
3e70: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 64   the number of d
3e80: 69 67 69 74 73 20 74 6f 20 74 68 65 20 72 69 67  igits to the rig
3e90: 68 74 20 6f 66 20 74 68 65 0a 64 65 63 69 6d 61  ht of the.decima
3ea0: 6c 20 70 6f 69 6e 74 20 74 6f 20 70 72 65 73 65  l point to prese
3eb0: 72 76 65 2e 20 20 49 66 20 74 68 65 20 73 65 63  rve.  If the sec
3ec0: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20  ond argument is 
3ed0: 6f 6d 69 74 74 65 64 2c 0a 7a 65 72 6f 20 69 73  omitted,.zero is
3ee0: 20 61 73 73 75 6d 65 64 2e 20 20 53 6f 20 72 6f   assumed.  So ro
3ef0: 75 6e 64 28 31 2e 32 33 34 35 36 2c 32 29 20 69  und(1.23456,2) i
3f00: 73 20 31 2e 32 33 20 61 6e 64 0a 72 6f 75 6e 64  s 1.23 and.round
3f10: 28 31 32 2e 33 34 2c 30 29 20 61 6e 64 20 72 6f  (12.34,0) and ro
3f20: 75 6e 64 28 31 32 2e 33 34 29 20 62 6f 74 68 20  und(12.34) both 
3f30: 65 76 61 6c 75 61 74 65 20 74 6f 20 31 32 2e 0a  evaluate to 12..
3f40: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 22 3c  </p>..<p>.The "<
3f50: 62 3e 63 6f 75 6e 74 28 2a 29 3c 2f 62 3e 22 20  b>count(*)</b>" 
3f60: 73 79 6e 74 61 78 20 69 73 20 73 75 70 70 6f 72  syntax is suppor
3f70: 74 65 64 20 62 75 74 0a 22 3c 62 3e 63 6f 75 6e  ted but."<b>coun
3f80: 74 28 64 69 73 74 69 6e 63 74 3c 2f 62 3e 20 3c  t(distinct</b> <
3f90: 69 3e 43 4f 4c 55 4d 4e 2d 4e 41 4d 45 3c 2f 69  i>COLUMN-NAME</i
3fa0: 3e 3c 62 3e 29 3c 2f 62 3e 22 20 69 73 20 6e 6f  ><b>)</b>" is no
3fb0: 74 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69  t..</p>.}..Secti
3fc0: 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73 65 72 74  on INSERT insert
3fd0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
3fe0: 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e 53 45 52  atement} {.INSER
3ff0: 54 20 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61  T INTO <table-na
4000: 6d 65 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c  me> [( <column-l
4010: 69 73 74 3e 20 29 5d 20 56 41 4c 55 45 53 20 28  ist> )] VALUES (
4020: 20 3c 76 61 6c 75 65 2d 6c 69 73 74 3e 20 29 20   <value-list> ) 
4030: 7c 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 3c 74  |.INSERT INTO <t
4040: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63  able-name> [( <c
4050: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 3c  olumn-list> )] <
4060: 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74  select-statement
4070: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  >.}..puts {.<p>T
4080: 68 65 20 49 4e 53 45 52 54 20 73 74 61 74 65 6d  he INSERT statem
4090: 65 6e 74 20 63 6f 6d 65 73 20 69 6e 20 74 77 6f  ent comes in two
40a0: 20 62 61 73 69 63 20 66 6f 72 6d 73 2e 20 20 54   basic forms.  T
40b0: 68 65 20 66 69 72 73 74 20 66 6f 72 6d 0a 28 77  he first form.(w
40c0: 69 74 68 20 74 68 65 20 22 56 41 4c 55 45 53 22  ith the "VALUES"
40d0: 20 6b 65 79 77 6f 72 64 29 20 63 72 65 61 74 65   keyword) create
40e0: 73 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 20 72  s a single new r
40f0: 6f 77 20 69 6e 20 61 6e 20 65 78 69 73 74 69 6e  ow in an existin
4100: 67 20 74 61 62 6c 65 2e 0a 49 66 20 6e 6f 20 63  g table..If no c
4110: 6f 6c 75 6d 6e 2d 6c 69 73 74 20 69 73 20 73 70  olumn-list is sp
4120: 65 63 69 66 69 65 64 20 74 68 65 6e 20 74 68 65  ecified then the
4130: 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65   number of value
4140: 73 20 6d 75 73 74 0a 62 65 20 74 68 65 20 73 61  s must.be the sa
4150: 6d 65 20 61 73 20 74 68 65 20 6e 75 6d 62 65 72  me as the number
4160: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
4170: 68 65 20 74 61 62 6c 65 2e 20 20 49 66 20 61 20  he table.  If a 
4180: 63 6f 6c 75 6d 6e 2d 6c 69 73 74 0a 69 73 20 73  column-list.is s
4190: 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 74  pecified, then t
41a0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c  he number of val
41b0: 75 65 73 20 6d 75 73 74 20 6d 61 74 63 68 20 74  ues must match t
41c0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 73 70 65  he number of.spe
41d0: 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 73 2e 20  cified columns. 
41e0: 20 43 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20   Columns of the 
41f0: 74 61 62 6c 65 20 74 68 61 74 20 64 6f 20 6e 6f  table that do no
4200: 74 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 0a  t appear in the.
4210: 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 61 72 65 20  column list are 
4220: 66 69 6c 6c 20 77 69 74 68 20 74 68 65 20 64 65  fill with the de
4230: 66 61 75 6c 74 20 76 61 6c 75 65 2c 20 6f 72 20  fault value, or 
4240: 77 69 74 68 20 4e 55 4c 4c 20 69 66 20 6e 6f 74  with NULL if not
4250: 0a 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69  .default value i
4260: 73 20 73 70 65 63 69 66 69 65 64 2e 0a 3c 2f 70  s specified..</p
4270: 3e 0a 0a 3c 70 3e 54 68 65 20 73 65 63 6f 6e 64  >..<p>The second
4280: 20 66 6f 72 6d 20 6f 66 20 74 68 65 20 49 4e 53   form of the INS
4290: 45 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 61  ERT statement ta
42a0: 6b 65 73 20 69 74 20 64 61 74 61 20 66 72 6f 6d  kes it data from
42b0: 20 61 0a 53 45 4c 45 43 54 20 73 74 61 74 65 6d   a.SELECT statem
42c0: 65 6e 74 2e 20 20 54 68 65 20 6e 75 6d 62 65 72  ent.  The number
42d0: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
42e0: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65  he result of the
42f0: 0a 53 45 4c 45 43 54 20 6d 75 73 74 20 65 78 61  .SELECT must exa
4300: 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 6e  ctly match the n
4310: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
4320: 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 69 66   in the table if
4330: 0a 6e 6f 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 20  .no column list 
4340: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 6f 72  is specified, or
4350: 20 69 74 20 6d 75 73 74 20 6d 61 74 63 68 20 74   it must match t
4360: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c  he number of col
4370: 75 6d 6e 73 0a 6e 61 6d 65 20 69 6e 20 74 68 65  umns.name in the
4380: 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 2e 20 20 41   column list.  A
4390: 20 6e 65 77 20 65 6e 74 72 79 20 69 73 20 6d 61   new entry is ma
43a0: 64 65 20 69 6e 20 74 68 65 20 74 61 62 6c 65 0a  de in the table.
43b0: 66 6f 72 20 65 76 65 72 79 20 72 6f 77 20 6f 66  for every row of
43c0: 20 74 68 65 20 53 45 4c 45 43 54 20 72 65 73 75   the SELECT resu
43d0: 6c 74 2e 20 20 54 68 65 20 53 45 4c 45 43 54 20  lt.  The SELECT 
43e0: 6d 61 79 20 62 65 20 73 69 6d 70 6c 65 0a 6f 72  may be simple.or
43f0: 20 63 6f 6d 70 6f 75 6e 64 2e 20 20 49 66 20 74   compound.  If t
4400: 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d  he SELECT statem
4410: 65 6e 74 20 68 61 73 20 61 6e 20 4f 52 44 45 52  ent has an ORDER
4420: 20 42 59 20 63 6c 61 75 73 65 2c 0a 74 68 65 20   BY clause,.the 
4430: 4f 52 44 45 52 20 42 59 20 69 73 20 69 67 6e 6f  ORDER BY is igno
4440: 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74  red.</p>.}..Sect
4450: 69 6f 6e 20 53 45 4c 45 43 54 20 73 65 6c 65 63  ion SELECT selec
4460: 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  t..Syntax {sql-s
4470: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 53 45 4c 45  tatement} {.SELE
4480: 43 54 20 3c 72 65 73 75 6c 74 3e 20 46 52 4f 4d  CT <result> FROM
4490: 20 3c 74 61 62 6c 65 2d 6c 69 73 74 3e 20 0a 5b   <table-list> .[
44a0: 57 48 45 52 45 20 3c 65 78 70 72 65 73 73 69 6f  WHERE <expressio
44b0: 6e 3e 5d 0a 5b 47 52 4f 55 50 20 42 59 20 3c 65  n>].[GROUP BY <e
44c0: 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b 48 41 56 49  xpr-list>].[HAVI
44d0: 4e 47 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d  NG <expression>]
44e0: 0a 5b 3c 63 6f 6d 70 6f 75 6e 64 2d 6f 70 3e 20  .[<compound-op> 
44f0: 3c 73 65 6c 65 63 74 3e 5d 2a 0a 5b 4f 52 44 45  <select>]*.[ORDE
4500: 52 20 42 59 20 3c 73 6f 72 74 2d 65 78 70 72 2d  R BY <sort-expr-
4510: 6c 69 73 74 3e 5d 0a 5b 4c 49 4d 49 54 20 3c 69  list>].[LIMIT <i
4520: 6e 74 65 67 65 72 3e 20 5b 4f 46 46 53 45 54 20  nteger> [OFFSET 
4530: 3c 69 6e 74 65 67 65 72 3e 5d 5d 0a 7d 20 7b 72  <integer>]].} {r
4540: 65 73 75 6c 74 7d 20 7b 0a 53 54 41 52 20 7c 20  esult} {.STAR | 
4550: 3c 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 20  <result-column> 
4560: 5b 2c 20 3c 72 65 73 75 6c 74 2d 63 6f 6c 75 6d  [, <result-colum
4570: 6e 3e 5d 2a 0a 7d 20 7b 72 65 73 75 6c 74 2d 63  n>]*.} {result-c
4580: 6f 6c 75 6d 6e 7d 20 7b 0a 3c 65 78 70 72 65 73  olumn} {.<expres
4590: 73 69 6f 6e 3e 20 5b 20 5b 41 53 5d 20 3c 73 74  sion> [ [AS] <st
45a0: 72 69 6e 67 3e 20 5d 0a 7d 20 7b 74 61 62 6c 65  ring> ].} {table
45b0: 2d 6c 69 73 74 7d 20 7b 0a 3c 74 61 62 6c 65 2d  -list} {.<table-
45c0: 6e 61 6d 65 3e 20 5b 2c 20 3c 74 61 62 6c 65 2d  name> [, <table-
45d0: 6e 61 6d 65 3e 5d 2a 0a 7d 20 7b 73 6f 72 74 2d  name>]*.} {sort-
45e0: 65 78 70 72 2d 6c 69 73 74 7d 20 7b 0a 3c 65 78  expr-list} {.<ex
45f0: 70 72 3e 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72  pr> [<sort-order
4600: 3e 5d 20 5b 2c 20 3c 65 78 70 72 3e 20 5b 3c 73  >] [, <expr> [<s
4610: 6f 72 74 2d 6f 72 64 65 72 3e 5d 5d 2a 0a 7d 20  ort-order>]]*.} 
4620: 7b 73 6f 72 74 2d 6f 72 64 65 72 7d 20 7b 0a 41  {sort-order} {.A
4630: 53 43 20 7c 20 44 45 53 43 0a 7d 20 7b 63 6f 6d  SC | DESC.} {com
4640: 70 6f 75 6e 64 5f 6f 70 7d 20 7b 0a 55 4e 49 4f  pound_op} {.UNIO
4650: 4e 20 7c 20 55 4e 49 4f 4e 20 41 4c 4c 20 7c 20  N | UNION ALL | 
4660: 49 4e 54 45 52 53 45 43 54 20 7c 20 45 58 43 45  INTERSECT | EXCE
4670: 50 54 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  PT.}..puts {.<p>
4680: 54 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65  The SELECT state
4690: 6d 65 6e 74 20 69 73 20 75 73 65 64 20 74 6f 20  ment is used to 
46a0: 71 75 65 72 79 20 74 68 65 20 64 61 74 61 62 61  query the databa
46b0: 73 65 2e 20 20 54 68 65 0a 72 65 73 75 6c 74 20  se.  The.result 
46c0: 6f 66 20 61 20 53 45 4c 45 43 54 20 69 73 20 7a  of a SELECT is z
46d0: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73  ero or more rows
46e0: 20 6f 66 20 64 61 74 61 20 77 68 65 72 65 20 65   of data where e
46f0: 61 63 68 20 72 6f 77 0a 68 61 73 20 61 20 66 69  ach row.has a fi
4700: 78 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  xed number of co
4710: 6c 75 6d 6e 73 2e 20 20 54 68 65 20 6e 75 6d 62  lumns.  The numb
4720: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e  er of columns in
4730: 20 74 68 65 0a 72 65 73 75 6c 74 20 69 73 20 73   the.result is s
4740: 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20  pecified by the 
4750: 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 20  expression list 
4760: 69 6e 20 62 65 74 77 65 65 6e 20 74 68 65 0a 53  in between the.S
4770: 45 4c 45 43 54 20 61 6e 64 20 46 52 4f 4d 20 6b  ELECT and FROM k
4780: 65 79 77 6f 72 64 73 2e 20 20 41 6e 79 20 61 72  eywords.  Any ar
4790: 62 69 74 72 61 72 79 20 65 78 70 72 65 73 73 69  bitrary expressi
47a0: 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 0a 61  on can be used.a
47b0: 73 20 61 20 72 65 73 75 6c 74 2e 20 20 49 66 20  s a result.  If 
47c0: 74 68 65 20 72 65 73 75 6c 74 20 73 70 65 63 69  the result speci
47d0: 66 69 63 61 74 69 6f 6e 20 69 73 20 6a 75 73 74  fication is just
47e0: 7d 0a 70 75 74 73 20 22 5b 4f 70 65 72 61 74 6f  }.puts "[Operato
47f0: 72 20 2a 5d 20 74 68 65 6e 20 61 6c 6c 20 63 6f  r *] then all co
4800: 6c 75 6d 6e 73 20 6f 66 20 61 6c 6c 20 74 61 62  lumns of all tab
4810: 6c 65 73 20 61 72 65 20 75 73 65 64 20 61 73 20  les are used as 
4820: 74 68 65 20 72 65 73 75 6c 74 2e 22 0a 70 75 74  the result.".put
4830: 73 20 7b 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  s {</p>..<p>The 
4840: 71 75 65 72 79 20 69 73 20 65 78 65 63 75 74 65  query is execute
4850: 64 20 61 67 61 69 6e 20 6f 6e 65 20 6f 72 20 6d  d again one or m
4860: 6f 72 65 20 74 61 62 6c 65 73 20 73 70 65 63 69  ore tables speci
4870: 66 69 65 64 20 61 66 74 65 72 0a 74 68 65 20 46  fied after.the F
4880: 52 4f 4d 20 6b 65 79 77 6f 72 64 2e 20 20 49 66  ROM keyword.  If
4890: 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 74   more than one t
48a0: 61 62 6c 65 20 69 73 20 73 70 65 63 69 66 69 65  able is specifie
48b0: 64 2c 20 74 68 65 6e 20 74 68 65 0a 71 75 65 72  d, then the.quer
48c0: 79 20 69 73 20 61 67 61 69 6e 73 74 20 74 68 65  y is against the
48d0: 20 6a 6f 69 6e 20 6f 66 20 74 68 65 20 76 61 72   join of the var
48e0: 69 6f 75 73 20 74 61 62 6c 65 73 2e 3c 2f 70 3e  ious tables.</p>
48f0: 0a 0a 3c 70 3e 54 68 65 20 57 48 45 52 45 20 63  ..<p>The WHERE c
4900: 6c 61 75 73 65 20 63 61 6e 20 62 65 20 75 73 65  lause can be use
4910: 64 20 74 6f 20 6c 69 6d 69 74 20 74 68 65 20 6e  d to limit the n
4920: 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 6f 76  umber of rows ov
4930: 65 72 0a 77 68 69 63 68 20 74 68 65 20 71 75 65  er.which the que
4940: 72 79 20 6f 70 65 72 61 74 65 73 2e 20 20 49 6e  ry operates.  In
4950: 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d 70   the current imp
4960: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 0a 69 6e 64  lementation,.ind
4970: 69 63 65 73 20 77 69 6c 6c 20 6f 6e 6c 79 20 62  ices will only b
4980: 65 20 75 73 65 64 20 74 6f 0a 6f 70 74 69 6d 69  e used to.optimi
4990: 7a 65 20 74 68 65 20 71 75 65 72 79 20 69 66 20  ze the query if 
49a0: 57 48 45 52 45 20 65 78 70 72 65 73 73 69 6f 6e  WHERE expression
49b0: 20 63 6f 6e 74 61 69 6e 73 20 65 71 75 61 6c 69   contains equali
49c0: 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e 73 0a 63  ty comparisons.c
49d0: 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68 65 20  onnected by the 
49e0: 41 4e 44 20 6f 70 65 72 61 74 6f 72 2e 3c 2f 70  AND operator.</p
49f0: 3e 0a 0a 3c 70 3e 54 68 65 20 47 52 4f 55 50 20  >..<p>The GROUP 
4a00: 42 59 20 63 6c 61 75 73 65 73 20 63 61 75 73 65  BY clauses cause
4a10: 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 72 6f  s one or more ro
4a20: 77 73 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ws of the result
4a30: 20 74 6f 0a 62 65 20 63 6f 6d 62 69 6e 65 64 20   to.be combined 
4a40: 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20 72 6f  into a single ro
4a50: 77 20 6f 66 20 6f 75 74 70 75 74 2e 20 20 54 68  w of output.  Th
4a60: 69 73 20 69 73 20 65 73 70 65 63 69 61 6c 6c 79  is is especially
4a70: 20 75 73 65 66 75 6c 0a 77 68 65 6e 20 74 68 65   useful.when the
4a80: 20 72 65 73 75 6c 74 20 63 6f 6e 74 61 69 6e 73   result contains
4a90: 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74   aggregate funct
4aa0: 69 6f 6e 73 2e 20 20 54 68 65 20 65 78 70 72 65  ions.  The expre
4ab0: 73 73 69 6f 6e 73 20 69 6e 0a 74 68 65 20 47 52  ssions in.the GR
4ac0: 4f 55 50 20 42 59 20 63 6c 61 75 73 65 20 64 6f  OUP BY clause do
4ad0: 20 3c 65 6d 3e 6e 6f 74 3c 2f 65 6d 3e 20 68 61   <em>not</em> ha
4ae0: 76 65 20 74 6f 20 62 65 20 65 78 70 72 65 73 73  ve to be express
4af0: 69 6f 6e 73 20 74 68 61 74 0a 61 70 70 65 61 72  ions that.appear
4b00: 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 20   in the result. 
4b10: 20 54 68 65 20 48 41 56 49 4e 47 20 63 6c 61 75   The HAVING clau
4b20: 73 65 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f  se is similar to
4b30: 20 57 48 45 52 45 20 65 78 63 65 70 74 0a 74 68   WHERE except.th
4b40: 61 74 20 48 41 56 49 4e 47 20 61 70 70 6c 69 65  at HAVING applie
4b50: 73 20 61 66 74 65 72 20 67 72 6f 75 70 69 6e 67  s after grouping
4b60: 20 68 61 73 20 6f 63 63 75 72 72 65 64 2e 20 20   has occurred.  
4b70: 54 68 65 20 48 41 56 49 4e 47 20 65 78 70 72 65  The HAVING expre
4b80: 73 73 69 6f 6e 0a 6d 61 79 20 72 65 66 65 72 20  ssion.may refer 
4b90: 74 6f 20 76 61 6c 75 65 73 2c 20 65 76 65 6e 20  to values, even 
4ba0: 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69  aggregate functi
4bb0: 6f 6e 73 2c 20 74 68 61 74 20 61 72 65 20 6e 6f  ons, that are no
4bc0: 74 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 2e  t in the result.
4bd0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f 52 44  </p>..<p>The ORD
4be0: 45 52 20 42 59 20 63 6c 61 75 73 65 20 63 61 75  ER BY clause cau
4bf0: 73 65 73 20 74 68 65 20 6f 75 74 70 75 74 20 72  ses the output r
4c00: 6f 77 73 20 74 6f 20 62 65 20 73 6f 72 74 65 64  ows to be sorted
4c10: 2e 20 20 0a 54 68 65 20 61 72 67 75 6d 65 6e 74  .  .The argument
4c20: 20 74 6f 20 4f 52 44 45 52 20 42 59 20 69 73 20   to ORDER BY is 
4c30: 61 20 6c 69 73 74 20 6f 66 20 65 78 70 72 65 73  a list of expres
4c40: 73 69 6f 6e 73 20 74 68 61 74 20 61 72 65 20 75  sions that are u
4c50: 73 65 64 20 61 73 20 74 68 65 0a 6b 65 79 20 66  sed as the.key f
4c60: 6f 72 20 74 68 65 20 73 6f 72 74 2e 20 20 54 68  or the sort.  Th
4c70: 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 64 6f  e expressions do
4c80: 20 6e 6f 74 20 68 61 76 65 20 74 6f 20 62 65 20   not have to be 
4c90: 70 61 72 74 20 6f 66 20 74 68 65 0a 72 65 73 75  part of the.resu
4ca0: 6c 74 20 66 6f 72 20 61 20 73 69 6d 70 6c 65 20  lt for a simple 
4cb0: 53 45 4c 45 43 54 2c 20 62 75 74 20 69 6e 20 61  SELECT, but in a
4cc0: 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54   compound SELECT
4cd0: 20 65 61 63 68 20 73 6f 72 74 0a 65 78 70 72 65   each sort.expre
4ce0: 73 73 69 6f 6e 20 6d 75 73 74 20 65 78 61 63 74  ssion must exact
4cf0: 6c 79 20 6d 61 74 63 68 20 6f 6e 65 20 6f 66 20  ly match one of 
4d00: 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d  the result colum
4d10: 6e 73 2e 20 20 45 61 63 68 0a 73 6f 72 74 20 65  ns.  Each.sort e
4d20: 78 70 72 65 73 73 69 6f 6e 20 6d 61 79 20 62 65  xpression may be
4d30: 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 66 6f 6c 6c   optionally foll
4d40: 6f 77 65 64 20 62 79 20 41 53 43 20 6f 72 20 44  owed by ASC or D
4d50: 45 53 43 20 74 6f 20 73 70 65 63 69 66 79 0a 74  ESC to specify.t
4d60: 68 65 20 73 6f 72 74 20 6f 72 64 65 72 2e 3c 2f  he sort order.</
4d70: 70 3e 0a 0a 3c 70 3e 54 68 65 20 4c 49 4d 49 54  p>..<p>The LIMIT
4d80: 20 63 6c 61 75 73 65 20 70 6c 61 63 65 73 20 61   clause places a
4d90: 6e 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e  n upper bound on
4da0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72   the number of r
4db0: 6f 77 73 0a 72 65 74 75 72 6e 65 64 20 69 6e 20  ows.returned in 
4dc0: 74 68 65 20 72 65 73 75 6c 74 2e 20 20 41 20 4c  the result.  A L
4dd0: 49 4d 49 54 20 6f 66 20 30 20 69 6e 64 69 63 61  IMIT of 0 indica
4de0: 74 65 73 20 6e 6f 20 75 70 70 65 72 20 62 6f 75  tes no upper bou
4df0: 6e 64 2e 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c  nd..The optional
4e00: 20 4f 46 46 53 45 54 20 66 6f 6c 6c 6f 77 69 6e   OFFSET followin
4e10: 67 20 4c 49 4d 49 54 20 73 70 65 63 69 66 69 65  g LIMIT specifie
4e20: 73 20 68 6f 77 20 6d 61 6e 79 0a 72 6f 77 73 20  s how many.rows 
4e30: 74 6f 20 73 6b 69 70 20 61 74 20 74 68 65 20 62  to skip at the b
4e40: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20  eginning of the 
4e50: 72 65 73 75 6c 74 20 73 65 74 2e 3c 2f 70 3e 0a  result set.</p>.
4e60: 0a 3c 70 3e 41 20 63 6f 6d 70 6f 75 6e 64 20 53  .<p>A compound S
4e70: 45 4c 45 43 54 20 69 73 20 66 6f 72 6d 65 64 20  ELECT is formed 
4e80: 66 72 6f 6d 20 74 77 6f 20 6f 72 20 6d 6f 72 65  from two or more
4e90: 20 73 69 6d 70 6c 65 20 53 45 4c 45 43 54 73 20   simple SELECTs 
4ea0: 63 6f 6e 6e 65 63 74 65 64 0a 62 79 20 6f 6e 65  connected.by one
4eb0: 20 6f 66 20 74 68 65 20 6f 70 65 72 61 74 6f 72   of the operator
4ec0: 73 20 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41  s UNION, UNION A
4ed0: 4c 4c 2c 20 49 4e 54 45 52 53 45 43 54 2c 20 6f  LL, INTERSECT, o
4ee0: 72 20 45 58 43 45 50 54 2e 20 20 49 6e 0a 61 20  r EXCEPT.  In.a 
4ef0: 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2c  compound SELECT,
4f00: 20 61 6c 6c 20 74 68 65 20 63 6f 6e 73 74 69 74   all the constit
4f10: 75 65 6e 74 20 53 45 4c 45 43 54 73 20 6d 75 73  uent SELECTs mus
4f20: 74 20 73 70 65 63 69 66 79 20 74 68 65 0a 73 61  t specify the.sa
4f30: 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73  me number of res
4f40: 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20 20 54 68  ult columns.  Th
4f50: 65 72 65 20 6d 61 79 20 62 65 20 6f 6e 6c 79 20  ere may be only 
4f60: 61 20 73 69 6e 67 6c 65 20 4f 52 44 45 52 20 42  a single ORDER B
4f70: 59 0a 63 6c 61 75 73 65 20 61 74 20 74 68 65 20  Y.clause at the 
4f80: 65 6e 64 20 6f 66 20 74 68 65 20 63 6f 6d 70 6f  end of the compo
4f90: 75 6e 64 20 53 45 4c 45 43 54 2e 20 20 54 68 65  und SELECT.  The
4fa0: 20 55 4e 49 4f 4e 20 61 6e 64 20 55 4e 49 4f 4e   UNION and UNION
4fb0: 20 41 4c 4c 0a 6f 70 65 72 61 74 6f 72 73 20 63   ALL.operators c
4fc0: 6f 6d 62 69 6e 65 20 74 68 65 20 72 65 73 75 6c  ombine the resul
4fd0: 74 73 20 6f 66 20 74 68 65 20 53 45 4c 45 43 54  ts of the SELECT
4fe0: 73 20 74 6f 20 74 68 65 20 72 69 67 68 74 20 61  s to the right a
4ff0: 6e 64 20 6c 65 66 74 20 69 6e 74 6f 0a 61 20 73  nd left into.a s
5000: 69 6e 67 6c 65 20 62 69 67 20 74 61 62 6c 65 2e  ingle big table.
5010: 20 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65    The difference
5020: 20 69 73 20 74 68 61 74 20 69 6e 20 55 4e 49 4f   is that in UNIO
5030: 4e 20 61 6c 6c 20 72 65 73 75 6c 74 20 72 6f 77  N all result row
5040: 73 0a 61 72 65 20 64 69 73 74 69 6e 63 74 20 77  s.are distinct w
5050: 68 65 72 65 20 69 6e 20 55 4e 49 4f 4e 20 41 4c  here in UNION AL
5060: 4c 20 74 68 65 72 65 20 6d 61 79 20 62 65 20 64  L there may be d
5070: 75 70 6c 69 63 61 74 65 73 2e 0a 54 68 65 20 49  uplicates..The I
5080: 4e 54 45 52 53 45 43 54 20 6f 70 65 72 61 74 6f  NTERSECT operato
5090: 72 20 74 61 6b 65 73 20 74 68 65 20 69 6e 74 65  r takes the inte
50a0: 72 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20  rsection of the 
50b0: 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65 0a 6c  results of the.l
50c0: 65 66 74 20 61 6e 64 20 72 69 67 68 74 20 53 45  eft and right SE
50d0: 4c 45 43 54 73 2e 20 20 45 58 43 45 50 54 20 74  LECTs.  EXCEPT t
50e0: 61 6b 65 73 20 74 68 65 20 72 65 73 75 6c 74 20  akes the result 
50f0: 6f 66 20 6c 65 66 74 20 53 45 4c 45 43 54 20 61  of left SELECT a
5100: 66 74 65 72 0a 72 65 6d 6f 76 69 6e 67 20 74 68  fter.removing th
5110: 65 20 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65  e results of the
5120: 20 72 69 67 68 74 20 53 45 4c 45 43 54 2e 20 20   right SELECT.  
5130: 57 68 65 6e 20 74 68 72 65 65 20 61 72 65 20 6d  When three are m
5140: 6f 72 65 20 53 45 4c 45 43 54 73 0a 61 72 65 20  ore SELECTs.are 
5150: 63 6f 6e 6e 65 63 74 65 64 20 69 6e 74 6f 20 61  connected into a
5160: 20 63 6f 6d 70 6f 75 6e 64 2c 20 74 68 65 79 20   compound, they 
5170: 67 72 6f 75 70 20 66 72 6f 6d 20 6c 65 66 74 20  group from left 
5180: 74 6f 20 72 69 67 68 74 2e 3c 2f 70 3e 0a 7d 0a  to right.</p>.}.
5190: 0a 53 65 63 74 69 6f 6e 20 55 50 44 41 54 45 20  .Section UPDATE 
51a0: 75 70 64 61 74 65 0a 0a 53 79 6e 74 61 78 20 7b  update..Syntax {
51b0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
51c0: 0a 55 50 44 41 54 45 20 3c 74 61 62 6c 65 2d 6e  .UPDATE <table-n
51d0: 61 6d 65 3e 20 53 45 54 20 3c 61 73 73 69 67 6e  ame> SET <assign
51e0: 6d 65 6e 74 3e 20 5b 2c 20 3c 61 73 73 69 67 6e  ment> [, <assign
51f0: 6d 65 6e 74 3e 5d 20 5b 57 48 45 52 45 20 3c 65  ment>] [WHERE <e
5200: 78 70 72 65 73 73 69 6f 6e 3e 5d 0a 7d 20 7b 61  xpression>].} {a
5210: 73 73 69 67 6e 6d 65 6e 74 7d 20 7b 0a 3c 63 6f  ssignment} {.<co
5220: 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 3d 20 3c 65 78  lumn-name> = <ex
5230: 70 72 65 73 73 69 6f 6e 3e 0a 7d 0a 0a 70 75 74  pression>.}..put
5240: 73 20 7b 0a 3c 70 3e 54 68 65 20 55 50 44 41 54  s {.<p>The UPDAT
5250: 45 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 75  E statement is u
5260: 73 65 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68  sed to change th
5270: 65 20 76 61 6c 75 65 20 6f 66 20 63 6f 6c 75 6d  e value of colum
5280: 6e 73 20 69 6e 20 0a 73 65 6c 65 63 74 65 64 20  ns in .selected 
5290: 72 6f 77 73 20 6f 66 20 61 20 74 61 62 6c 65 2e  rows of a table.
52a0: 20 20 45 61 63 68 20 61 73 73 69 67 6e 6d 65 6e    Each assignmen
52b0: 74 20 69 6e 20 61 6e 20 55 50 44 41 54 45 20 73  t in an UPDATE s
52c0: 70 65 63 69 66 69 65 73 0a 61 20 63 6f 6c 75 6d  pecifies.a colum
52d0: 6e 20 6e 61 6d 65 20 74 6f 20 74 68 65 20 6c 65  n name to the le
52e0: 66 74 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73  ft of the equals
52f0: 20 73 69 67 6e 20 61 6e 64 20 61 6e 20 61 72 62   sign and an arb
5300: 69 74 72 61 72 79 20 65 78 70 72 65 73 73 69 6f  itrary expressio
5310: 6e 0a 74 6f 20 74 68 65 20 72 69 67 68 74 2e 20  n.to the right. 
5320: 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73   The expressions
5330: 20 6d 61 79 20 75 73 65 20 74 68 65 20 76 61 6c   may use the val
5340: 75 65 73 20 6f 66 20 6f 74 68 65 72 20 63 6f 6c  ues of other col
5350: 75 6d 6e 73 2e 0a 41 6c 6c 20 65 78 70 72 65 73  umns..All expres
5360: 73 69 6f 6e 73 20 61 72 65 20 65 76 61 6c 75 61  sions are evalua
5370: 74 65 64 20 62 65 66 6f 72 65 20 61 6e 79 20 61  ted before any a
5380: 73 73 69 67 6e 6d 65 6e 74 73 20 61 72 65 20 6d  ssignments are m
5390: 61 64 65 2e 0a 41 20 57 48 45 52 45 20 63 6c 61  ade..A WHERE cla
53a0: 75 73 65 20 63 61 6e 20 62 65 20 75 73 65 64 20  use can be used 
53b0: 74 6f 20 72 65 73 74 72 69 63 74 20 77 68 69 63  to restrict whic
53c0: 68 20 72 6f 77 73 20 61 72 65 20 75 70 64 61 74  h rows are updat
53d0: 65 64 2e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 56  ed..}..Section V
53e0: 41 43 55 55 4d 20 76 61 63 75 75 6d 0a 0a 53 79  ACUUM vacuum..Sy
53f0: 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d  ntax {sql-statem
5400: 65 6e 74 7d 20 7b 0a 56 41 43 55 55 4d 20 5b 3c  ent} {.VACUUM [<
5410: 69 6e 64 65 78 2d 6f 72 2d 74 61 62 6c 65 2d 6e  index-or-table-n
5420: 61 6d 65 3e 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a  ame>].}..puts {.
5430: 3c 70 3e 54 68 65 20 56 41 43 55 55 4d 20 63 6f  <p>The VACUUM co
5440: 6d 6d 61 6e 64 20 69 73 20 61 6e 20 53 51 4c 69  mmand is an SQLi
5450: 74 65 20 65 78 74 65 6e 73 69 6f 6e 20 6d 6f 64  te extension mod
5460: 65 6c 6c 65 64 20 61 66 74 65 72 20 61 20 73 69  elled after a si
5470: 6d 69 6c 61 72 0a 63 6f 6d 6d 61 6e 64 20 66 6f  milar.command fo
5480: 75 6e 64 20 69 6e 20 50 6f 73 74 67 72 65 53 51  und in PostgreSQ
5490: 4c 2e 20 20 49 66 20 56 41 43 55 55 4d 20 69 73  L.  If VACUUM is
54a0: 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 74 68   invoked with th
54b0: 65 20 6e 61 6d 65 20 6f 66 20 61 0a 74 61 62 6c  e name of a.tabl
54c0: 65 20 6f 72 20 69 6e 64 65 78 20 74 68 65 6e 20  e or index then 
54d0: 69 74 20 69 73 20 73 75 70 70 6f 73 65 20 74 6f  it is suppose to
54e0: 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20 6e 61   clean up the na
54f0: 6d 65 64 20 74 61 62 6c 65 20 6f 72 20 69 6e 64  med table or ind
5500: 65 78 2e 0a 49 6e 20 76 65 72 73 69 6f 6e 20 31  ex..In version 1
5510: 2e 30 20 6f 66 20 53 51 4c 69 74 65 2c 20 74 68  .0 of SQLite, th
5520: 65 20 56 41 43 55 55 4d 20 63 6f 6d 6d 61 6e 64  e VACUUM command
5530: 20 77 6f 75 6c 64 20 69 6e 76 6f 6b 65 20 0a 3c   would invoke .<
5540: 62 3e 67 64 62 6d 5f 72 65 6f 72 67 61 6e 69 7a  b>gdbm_reorganiz
5550: 65 28 29 3c 2f 62 3e 20 74 6f 20 63 6c 65 61 6e  e()</b> to clean
5560: 20 75 70 20 74 68 65 20 62 61 63 6b 65 6e 64 20   up the backend 
5570: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 42  database file..B
5580: 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 76 65  eginning with ve
5590: 72 73 69 6f 6e 20 32 2e 30 20 6f 66 20 53 51 4c  rsion 2.0 of SQL
55a0: 69 74 65 2c 20 47 44 42 4d 20 69 73 20 6e 6f 20  ite, GDBM is no 
55b0: 6c 6f 6e 67 65 72 20 75 73 65 64 20 66 6f 72 0a  longer used for.
55c0: 74 68 65 20 64 61 74 61 62 61 73 65 20 62 61 63  the database bac
55d0: 6b 65 6e 64 20 61 6e 64 20 56 41 43 55 55 4d 20  kend and VACUUM 
55e0: 68 61 73 20 62 65 63 6f 6d 65 20 61 20 6e 6f 2d  has become a no-
55f0: 6f 70 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74  op..</p>.}..Sect
5600: 69 6f 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d  ion PRAGMA pragm
5610: 61 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  a..Syntax {sql-s
5620: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47  tatement} {.PRAG
5630: 4d 41 20 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c  MA <name> = <val
5640: 75 65 3e 20 7c 0a 50 52 41 47 4d 41 20 3c 66 75  ue> |.PRAGMA <fu
5650: 6e 63 74 69 6f 6e 3e 28 3c 61 72 67 3e 29 0a 7d  nction>(<arg>).}
5660: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
5670: 50 52 41 47 4d 41 20 63 6f 6d 6d 61 6e 64 20 69  PRAGMA command i
5680: 73 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79  s used to modify
5690: 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f   the operation o
56a0: 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62  f the SQLite lib
56b0: 72 61 72 79 2e 0a 54 68 65 20 70 72 61 67 6d 61  rary..The pragma
56c0: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65 78 70 65   command is expe
56d0: 72 69 6d 65 6e 74 61 6c 20 61 6e 64 20 73 70 65  rimental and spe
56e0: 63 69 66 69 63 20 70 72 61 67 6d 61 20 73 74 61  cific pragma sta
56f0: 74 65 6d 65 6e 74 73 20 6d 61 79 0a 72 65 6d 6f  tements may.remo
5700: 76 65 64 20 6f 72 20 61 64 64 65 64 20 69 6e 20  ved or added in 
5710: 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 20  future releases 
5720: 6f 66 20 53 51 4c 69 74 65 2e 20 20 55 73 65 20  of SQLite.  Use 
5730: 74 68 69 73 20 63 6f 6d 6d 61 6e 64 0a 77 69 74  this command.wit
5740: 68 20 63 61 75 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  h caution.</p>..
5750: 3c 70 3e 54 68 65 20 63 75 72 72 65 6e 74 20 69  <p>The current i
5760: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 75  mplementation su
5770: 70 70 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f  pports the follo
5780: 77 69 6e 67 20 70 72 61 67 6d 61 73 3a 3c 2f 70  wing pragmas:</p
5790: 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c  >..<ul>.<li><p><
57a0: 62 3e 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73  b>PRAGMA cache_s
57b0: 69 7a 65 20 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d  ize = </b><i>Num
57c0: 62 65 72 2d 6f 66 2d 70 61 67 65 73 3c 2f 69 3e  ber-of-pages</i>
57d0: 3c 62 3e 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  <b>;</b></p>.   
57e0: 20 3c 70 3e 43 68 61 6e 67 65 20 74 68 65 20 6d   <p>Change the m
57f0: 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  aximum number of
5800: 20 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 70   database disk p
5810: 61 67 65 73 20 74 68 61 74 20 53 51 4c 69 74 65  ages that SQLite
5820: 0a 20 20 20 20 77 69 6c 6c 20 68 6f 6c 64 20 69  .    will hold i
5830: 6e 20 6d 65 6d 6f 72 79 20 61 74 20 6f 6e 63 65  n memory at once
5840: 2e 20 20 45 61 63 68 20 70 61 67 65 20 75 73 65  .  Each page use
5850: 73 20 61 62 6f 75 74 20 31 2e 35 4b 20 6f 66 20  s about 1.5K of 
5860: 52 41 4d 2e 0a 20 20 20 20 54 68 65 20 64 65 66  RAM..    The def
5870: 61 75 6c 74 20 63 61 63 68 65 20 73 69 7a 65 20  ault cache size 
5880: 69 73 20 31 30 30 2e 20 20 49 66 20 79 6f 75 20  is 100.  If you 
5890: 61 72 65 20 64 6f 69 6e 67 20 55 50 44 41 54 45  are doing UPDATE
58a0: 73 20 6f 72 20 44 45 4c 45 54 45 73 0a 20 20 20  s or DELETEs.   
58b0: 20 74 68 61 74 20 63 68 61 6e 67 65 20 6d 61 6e   that change man
58c0: 79 20 72 6f 77 73 20 6f 66 20 61 20 64 61 74 61  y rows of a data
58d0: 62 61 73 65 20 61 6e 64 20 79 6f 75 20 64 6f 20  base and you do 
58e0: 6e 6f 74 20 6d 69 6e 64 20 69 66 20 53 51 4c 69  not mind if SQLi
58f0: 74 65 0a 20 20 20 20 75 73 65 73 20 6d 6f 72 65  te.    uses more
5900: 20 6d 65 6d 6f 72 79 2c 20 79 6f 75 20 63 61 6e   memory, you can
5910: 20 69 6e 63 72 65 61 73 65 20 74 68 65 20 63 61   increase the ca
5920: 63 68 65 20 73 69 7a 65 20 66 6f 72 20 61 20 70  che size for a p
5930: 6f 73 73 69 62 6c 65 20 73 70 65 65 64 0a 20 20  ossible speed.  
5940: 20 20 69 6d 70 72 6f 76 65 6d 65 6e 74 2e 3c 2f    improvement.</
5950: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
5960: 3c 62 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f  <b>PRAGMA count_
5970: 63 68 61 6e 67 65 73 20 3d 20 4f 4e 3b 0a 20 20  changes = ON;.  
5980: 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20       <br>PRAGMA 
5990: 63 6f 75 6e 74 5f 63 68 61 6e 67 65 73 20 3d 20  count_changes = 
59a0: 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  OFF;</b></p>.   
59b0: 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68 65   <p>When on, the
59c0: 20 43 4f 55 4e 54 5f 43 48 41 4e 47 45 53 20 70   COUNT_CHANGES p
59d0: 72 61 67 6d 61 20 63 61 75 73 65 73 20 74 68 65  ragma causes the
59e0: 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69   callback functi
59f0: 6f 6e 20 74 6f 0a 20 20 20 20 62 65 20 69 6e 76  on to.    be inv
5a00: 6f 6b 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61  oked once for ea
5a10: 63 68 20 44 45 4c 45 54 45 2c 20 49 4e 53 45 52  ch DELETE, INSER
5a20: 54 2c 20 6f 72 20 55 50 44 41 54 45 20 6f 70 65  T, or UPDATE ope
5a30: 72 61 74 69 6f 6e 2e 20 20 54 68 65 0a 20 20 20  ration.  The.   
5a40: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65   argument is the
5a50: 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20   number of rows 
5a60: 74 68 61 74 20 77 65 72 65 20 63 68 61 6e 67 65  that were change
5a70: 64 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c  d.</p>..<li><p><
5a80: 62 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72  b>PRAGMA empty_r
5a90: 65 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20  esult_callbacks 
5aa0: 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72  = ON;.       <br
5ab0: 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65  >PRAGMA empty_re
5ac0: 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d  sult_callbacks =
5ad0: 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20   OFF;</b></p>.  
5ae0: 20 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68    <p>When on, th
5af0: 65 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43  e EMPTY_RESULT_C
5b00: 41 4c 4c 42 41 43 4b 53 20 70 72 61 67 6d 61 20  ALLBACKS pragma 
5b10: 63 61 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62  causes the callb
5b20: 61 63 6b 0a 20 20 20 20 66 75 6e 63 74 69 6f 6e  ack.    function
5b30: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f   to be invoked o
5b40: 6e 63 65 20 66 6f 72 20 65 61 63 68 20 71 75 65  nce for each que
5b50: 72 79 20 74 68 61 74 20 68 61 73 20 61 6e 20 65  ry that has an e
5b60: 6d 70 74 79 20 72 65 73 75 6c 74 0a 20 20 20 20  mpty result.    
5b70: 73 65 74 2e 20 20 54 68 65 20 74 68 69 72 64 20  set.  The third 
5b80: 22 3c 62 3e 61 72 67 76 3c 2f 62 3e 22 20 70 61  "<b>argv</b>" pa
5b90: 72 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20 63  rameter to the c
5ba0: 61 6c 6c 62 61 63 6b 20 69 73 20 73 65 74 20 74  allback is set t
5bb0: 6f 20 4e 55 4c 4c 0a 20 20 20 20 62 65 63 61 75  o NULL.    becau
5bc0: 73 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64  se there is no d
5bd0: 61 74 61 20 74 6f 20 72 65 70 6f 72 74 2e 20 20  ata to report.  
5be0: 42 75 74 20 74 68 65 20 73 65 63 6f 6e 64 20 22  But the second "
5bf0: 3c 62 3e 61 72 67 63 3c 2f 62 3e 22 20 61 6e 64  <b>argc</b>" and
5c00: 0a 20 20 20 20 66 6f 75 72 74 68 20 22 3c 62 3e  .    fourth "<b>
5c10: 63 6f 6c 75 6d 6e 4e 61 6d 65 73 3c 2f 62 3e 22  columnNames</b>"
5c20: 20 70 61 72 61 6d 65 74 65 72 73 20 61 72 65 20   parameters are 
5c30: 76 61 6c 69 64 20 61 6e 64 20 63 61 6e 20 62 65  valid and can be
5c40: 20 75 73 65 64 20 74 6f 0a 20 20 20 20 64 65 74   used to.    det
5c50: 65 72 6d 69 6e 65 20 74 68 65 20 6e 75 6d 62 65  ermine the numbe
5c60: 72 20 61 6e 64 20 6e 61 6d 65 73 20 6f 66 20 74  r and names of t
5c70: 68 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20  he columns that 
5c80: 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20  would have been 
5c90: 69 6e 0a 20 20 20 20 74 68 65 20 72 65 73 75 6c  in.    the resul
5ca0: 74 20 73 65 74 20 68 61 64 20 74 68 65 20 73 65  t set had the se
5cb0: 74 20 6e 6f 74 20 62 65 65 6e 20 65 6d 70 74 79  t not been empty
5cc0: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
5cd0: 3e 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f 6c  >PRAGMA full_col
5ce0: 75 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 4e 3b 0a  umn_names = ON;.
5cf0: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
5d00: 41 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61  A full_column_na
5d10: 6d 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f  mes = OFF;</b></
5d20: 70 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f  p>.    <p>The co
5d30: 6c 75 6d 6e 20 6e 61 6d 65 73 20 72 65 70 6f 72  lumn names repor
5d40: 74 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65  ted in an SQLite
5d50: 20 63 61 6c 6c 62 61 63 6b 20 61 72 65 20 6e 6f   callback are no
5d60: 72 6d 61 6c 6c 79 20 6a 75 73 74 0a 20 20 20 20  rmally just.    
5d70: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
5d80: 63 6f 6c 75 6d 6e 20 69 74 73 65 6c 66 2c 20 65  column itself, e
5d90: 78 63 65 70 74 20 66 6f 72 20 6a 6f 69 6e 73 20  xcept for joins 
5da0: 77 68 65 6e 20 22 54 41 42 4c 45 2e 43 4f 4c 55  when "TABLE.COLU
5db0: 4d 4e 22 0a 20 20 20 20 69 73 20 75 73 65 64 2e  MN".    is used.
5dc0: 20 20 42 75 74 20 77 68 65 6e 20 66 75 6c 6c 5f    But when full_
5dd0: 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 69 73 20  column_names is 
5de0: 74 75 72 6e 65 64 20 6f 6e 2c 20 63 6f 6c 75 6d  turned on, colum
5df0: 6e 20 6e 61 6d 65 73 20 61 72 65 0a 20 20 20 20  n names are.    
5e00: 61 6c 77 61 79 73 20 72 65 70 6f 72 74 65 64 20  always reported 
5e10: 61 73 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e  as "TABLE.COLUMN
5e20: 22 20 65 76 65 6e 20 66 6f 72 20 73 69 6d 70 6c  " even for simpl
5e30: 65 20 71 75 65 72 69 65 73 2e 3c 2f 70 3e 3c 2f  e queries.</p></
5e40: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50  li>..<li><p><b>P
5e50: 52 41 47 4d 41 20 69 6e 64 65 78 5f 69 6e 66 6f  RAGMA index_info
5e60: 28 3c 2f 62 3e 3c 69 3e 69 6e 64 65 78 2d 6e 61  (</b><i>index-na
5e70: 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c  me</i><b>);</b><
5e80: 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65  /p>.    <p>For e
5e90: 61 63 68 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20  ach column that 
5ea0: 74 68 65 20 6e 61 6d 65 64 20 69 6e 64 65 78 20  the named index 
5eb0: 72 65 66 65 72 65 6e 63 65 73 2c 20 69 6e 76 6f  references, invo
5ec0: 6b 65 20 74 68 65 20 0a 20 20 20 20 63 61 6c 6c  ke the .    call
5ed0: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20  back function.  
5ee0: 20 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f    once with info
5ef0: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68  rmation about th
5f00: 61 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75  at column, inclu
5f10: 64 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ding the column 
5f20: 6e 61 6d 65 2c 0a 20 20 20 20 61 6e 64 20 74 68  name,.    and th
5f30: 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 2e  e column number.
5f40: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
5f50: 50 52 41 47 4d 41 20 69 6e 64 65 78 5f 6c 69 73  PRAGMA index_lis
5f60: 74 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e  t(</b><i>table-n
5f70: 61 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e  ame</i><b>);</b>
5f80: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20  </p>.    <p>For 
5f90: 65 61 63 68 20 69 6e 64 65 78 20 6f 6e 20 74 68  each index on th
5fa0: 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69  e named table, i
5fb0: 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61  nvoke the callba
5fc0: 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20  ck function.    
5fd0: 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d  once with inform
5fe0: 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74  ation about that
5ff0: 20 69 6e 64 65 78 2e 20 20 41 72 67 75 6d 65 6e   index.  Argumen
6000: 74 73 20 69 6e 63 6c 75 64 65 20 74 68 65 0a 20  ts include the. 
6010: 20 20 20 69 6e 64 65 78 20 6e 61 6d 65 20 61 6e     index name an
6020: 64 20 61 20 66 6c 61 67 20 74 6f 20 69 6e 64 69  d a flag to indi
6030: 63 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20  cate whether or 
6040: 6e 6f 74 20 74 68 65 20 69 6e 64 65 78 20 6d 75  not the index mu
6050: 73 74 20 62 65 0a 20 20 20 20 75 6e 69 71 75 65  st be.    unique
6060: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
6070: 3e 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74  >PRAGMA parser_t
6080: 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52  race = ON;<br>PR
6090: 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72 61 63  AGMA parser_trac
60a0: 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e  e = OFF;</b></p>
60b0: 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61  .    <p>Turn tra
60c0: 63 69 6e 67 20 6f 66 20 74 68 65 20 53 51 4c 20  cing of the SQL 
60d0: 70 61 72 73 65 72 20 69 6e 73 69 64 65 20 6f 66  parser inside of
60e0: 20 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20   the.    SQLite 
60f0: 6c 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f  library on and o
6100: 66 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65  ff.  This is use
6110: 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e  d for debugging.
6120: 0a 20 20 20 20 54 68 69 73 20 6f 6e 6c 79 20 77  .    This only w
6130: 6f 72 6b 73 20 69 66 20 74 68 65 20 6c 69 62 72  orks if the libr
6140: 61 72 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20  ary is compiled 
6150: 77 69 74 68 6f 75 74 20 74 68 65 20 4e 44 45 42  without the NDEB
6160: 55 47 20 6d 61 63 72 6f 2e 0a 20 20 20 20 3c 2f  UG macro..    </
6170: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
6180: 3c 62 3e 50 52 41 47 4d 41 20 74 61 62 6c 65 5f  <b>PRAGMA table_
6190: 69 6e 66 6f 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c  info(</b><i>tabl
61a0: 65 2d 6e 61 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c  e-name</i><b>);<
61b0: 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 46  /b></p>.    <p>F
61c0: 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 69  or each column i
61d0: 6e 20 74 68 65 20 6e 61 6d 65 64 20 74 61 62 6c  n the named tabl
61e0: 65 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 61  e, invoke the ca
61f0: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a  llback function.
6200: 20 20 20 20 6f 6e 63 65 20 77 69 74 68 20 69 6e      once with in
6210: 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20  formation about 
6220: 74 68 61 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63  that column, inc
6230: 6c 75 64 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d  luding the colum
6240: 6e 20 6e 61 6d 65 2c 0a 20 20 20 20 64 61 74 61  n name,.    data
6250: 20 74 79 70 65 2c 20 77 68 65 74 68 65 72 20 6f   type, whether o
6260: 72 20 6e 6f 74 20 74 68 65 20 63 6f 6c 75 6d 6e  r not the column
6270: 20 63 61 6e 20 62 65 20 4e 55 4c 4c 2c 20 61 6e   can be NULL, an
6280: 64 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20  d the default.  
6290: 20 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20    value for the 
62a0: 63 6f 6c 75 6d 6e 2e 3c 2f 70 3e 0a 0a 3c 6c 69  column.</p>..<li
62b0: 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 76 64  ><p><b>PRAGMA vd
62c0: 62 65 5f 74 72 61 63 65 20 3d 20 4f 4e 3b 3c 62  be_trace = ON;<b
62d0: 72 3e 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72  r>PRAGMA vdbe_tr
62e0: 61 63 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f  ace = OFF;</b></
62f0: 70 3e 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74  p>.    <p>Turn t
6300: 72 61 63 69 6e 67 20 6f 66 20 74 68 65 20 76 69  racing of the vi
6310: 72 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 65  rtual database e
6320: 6e 67 69 6e 65 20 69 6e 73 69 64 65 20 6f 66 20  ngine inside of 
6330: 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c  the.    SQLite l
6340: 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66  ibrary on and of
6350: 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  f.  This is used
6360: 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 3c   for debugging.<
6370: 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a  /p></li>.</ul>..
6380: 3c 70 3e 4e 6f 20 65 72 72 6f 72 20 6d 65 73 73  <p>No error mess
6390: 61 67 65 20 69 73 20 67 65 6e 65 72 61 74 65 64  age is generated
63a0: 20 69 66 20 61 6e 20 75 6e 6b 6e 6f 77 6e 20 70   if an unknown p
63b0: 72 61 67 6d 61 20 69 73 20 69 73 73 75 65 64 2e  ragma is issued.
63c0: 0a 55 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 73  .Unknown pragmas
63d0: 20 61 72 65 20 69 67 6e 6f 72 65 64 2e 3c 2f 70   are ignored.</p
63e0: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 3c  >.}..puts {.<p><
63f0: 2f 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  /p>.}..puts {.<p
6400: 3e 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 3c  ><hr /></p>.<p><
6410: 61 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74  a href="index.ht
6420: 6d 6c 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67  ml"><img src="/g
6430: 6f 62 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65  oback.jpg" borde
6440: 72 3d 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74  r=0 />.Back to t
6450: 68 65 20 53 51 4c 69 74 65 20 48 6f 6d 65 20 50  he SQLite Home P
6460: 61 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f  age</a>.</p>..</
6470: 62 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a        body></html>}.