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

Artifact 37d4a44bdafe42a270b9e28554651278086ce806:


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 33 20 32 30 30 31  .tcl,v 1.13 2001
0060: 2f 31 30 2f 31 35 20 30 30 3a 34 34 3a 33 36 20  /10/15 00:44:36 
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 7d 20 7b 72 65 73 75 6c 74  list>].} {result
4520: 7d 20 7b 0a 53 54 41 52 20 7c 20 3c 72 65 73 75  } {.STAR | <resu
4530: 6c 74 2d 63 6f 6c 75 6d 6e 3e 20 5b 2c 20 3c 72  lt-column> [, <r
4540: 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 5d 2a 0a  esult-column>]*.
4550: 7d 20 7b 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e  } {result-column
4560: 7d 20 7b 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e  } {.<expression>
4570: 20 5b 20 5b 41 53 5d 20 3c 73 74 72 69 6e 67 3e   [ [AS] <string>
4580: 20 5d 0a 7d 20 7b 74 61 62 6c 65 2d 6c 69 73 74   ].} {table-list
4590: 7d 20 7b 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  } {.<table-name>
45a0: 20 5b 2c 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e   [, <table-name>
45b0: 5d 2a 0a 7d 20 7b 73 6f 72 74 2d 65 78 70 72 2d  ]*.} {sort-expr-
45c0: 6c 69 73 74 7d 20 7b 0a 3c 65 78 70 72 3e 20 5b  list} {.<expr> [
45d0: 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20 5b 2c  <sort-order>] [,
45e0: 20 3c 65 78 70 72 3e 20 5b 3c 73 6f 72 74 2d 6f   <expr> [<sort-o
45f0: 72 64 65 72 3e 5d 5d 2a 0a 7d 20 7b 73 6f 72 74  rder>]]*.} {sort
4600: 2d 6f 72 64 65 72 7d 20 7b 0a 41 53 43 20 7c 20  -order} {.ASC | 
4610: 44 45 53 43 0a 7d 20 7b 63 6f 6d 70 6f 75 6e 64  DESC.} {compound
4620: 5f 6f 70 7d 20 7b 0a 55 4e 49 4f 4e 20 7c 20 55  _op} {.UNION | U
4630: 4e 49 4f 4e 20 41 4c 4c 20 7c 20 49 4e 54 45 52  NION ALL | INTER
4640: 53 45 43 54 20 7c 20 45 58 43 45 50 54 0a 7d 0a  SECT | EXCEPT.}.
4650: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 53  .puts {.<p>The S
4660: 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20  ELECT statement 
4670: 69 73 20 75 73 65 64 20 74 6f 20 71 75 65 72 79  is used to query
4680: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20   the database.  
4690: 54 68 65 0a 72 65 73 75 6c 74 20 6f 66 20 61 20  The.result of a 
46a0: 53 45 4c 45 43 54 20 69 73 20 7a 65 72 6f 20 6f  SELECT is zero o
46b0: 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66 20 64  r more rows of d
46c0: 61 74 61 20 77 68 65 72 65 20 65 61 63 68 20 72  ata where each r
46d0: 6f 77 0a 68 61 73 20 61 20 66 69 78 65 64 20 6e  ow.has a fixed n
46e0: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
46f0: 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  .  The number of
4700: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 0a   columns in the.
4710: 72 65 73 75 6c 74 20 69 73 20 73 70 65 63 69 66  result is specif
4720: 69 65 64 20 62 79 20 74 68 65 20 65 78 70 72 65  ied by the expre
4730: 73 73 69 6f 6e 20 6c 69 73 74 20 69 6e 20 62 65  ssion list in be
4740: 74 77 65 65 6e 20 74 68 65 0a 53 45 4c 45 43 54  tween the.SELECT
4750: 20 61 6e 64 20 46 52 4f 4d 20 6b 65 79 77 6f 72   and FROM keywor
4760: 64 73 2e 20 20 41 6e 79 20 61 72 62 69 74 72 61  ds.  Any arbitra
4770: 72 79 20 65 78 70 72 65 73 73 69 6f 6e 20 63 61  ry expression ca
4780: 6e 20 62 65 20 75 73 65 64 0a 61 73 20 61 20 72  n be used.as a r
4790: 65 73 75 6c 74 2e 20 20 49 66 20 74 68 65 20 72  esult.  If the r
47a0: 65 73 75 6c 74 20 73 70 65 63 69 66 69 63 61 74  esult specificat
47b0: 69 6f 6e 20 69 73 20 6a 75 73 74 7d 0a 70 75 74  ion is just}.put
47c0: 73 20 22 5b 4f 70 65 72 61 74 6f 72 20 2a 5d 20  s "[Operator *] 
47d0: 74 68 65 6e 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73  then all columns
47e0: 20 6f 66 20 61 6c 6c 20 74 61 62 6c 65 73 20 61   of all tables a
47f0: 72 65 20 75 73 65 64 20 61 73 20 74 68 65 20 72  re used as the r
4800: 65 73 75 6c 74 2e 22 0a 70 75 74 73 20 7b 3c 2f  esult.".puts {</
4810: 70 3e 0a 0a 3c 70 3e 54 68 65 20 71 75 65 72 79  p>..<p>The query
4820: 20 69 73 20 65 78 65 63 75 74 65 64 20 61 67 61   is executed aga
4830: 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 74  in one or more t
4840: 61 62 6c 65 73 20 73 70 65 63 69 66 69 65 64 20  ables specified 
4850: 61 66 74 65 72 0a 74 68 65 20 46 52 4f 4d 20 6b  after.the FROM k
4860: 65 79 77 6f 72 64 2e 20 20 49 66 20 6d 6f 72 65  eyword.  If more
4870: 20 74 68 61 6e 20 6f 6e 65 20 74 61 62 6c 65 20   than one table 
4880: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 74 68  is specified, th
4890: 65 6e 20 74 68 65 0a 71 75 65 72 79 20 69 73 20  en the.query is 
48a0: 61 67 61 69 6e 73 74 20 74 68 65 20 6a 6f 69 6e  against the join
48b0: 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20   of the various 
48c0: 74 61 62 6c 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e  tables.</p>..<p>
48d0: 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65  The WHERE clause
48e0: 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20   can be used to 
48f0: 6c 69 6d 69 74 20 74 68 65 20 6e 75 6d 62 65 72  limit the number
4900: 20 6f 66 20 72 6f 77 73 20 6f 76 65 72 0a 77 68   of rows over.wh
4910: 69 63 68 20 74 68 65 20 71 75 65 72 79 20 6f 70  ich the query op
4920: 65 72 61 74 65 73 2e 20 20 49 6e 20 74 68 65 20  erates.  In the 
4930: 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e  current implemen
4940: 74 61 74 69 6f 6e 2c 0a 69 6e 64 69 63 65 73 20  tation,.indices 
4950: 77 69 6c 6c 20 6f 6e 6c 79 20 62 65 20 75 73 65  will only be use
4960: 64 20 74 6f 0a 6f 70 74 69 6d 69 7a 65 20 74 68  d to.optimize th
4970: 65 20 71 75 65 72 79 20 69 66 20 57 48 45 52 45  e query if WHERE
4980: 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 6e 74   expression cont
4990: 61 69 6e 73 20 65 71 75 61 6c 69 74 79 20 63 6f  ains equality co
49a0: 6d 70 61 72 69 73 6f 6e 73 0a 63 6f 6e 6e 65 63  mparisons.connec
49b0: 74 65 64 20 62 79 20 74 68 65 20 41 4e 44 20 6f  ted by the AND o
49c0: 70 65 72 61 74 6f 72 2e 3c 2f 70 3e 0a 0a 3c 70  perator.</p>..<p
49d0: 3e 54 68 65 20 47 52 4f 55 50 20 42 59 20 63 6c  >The GROUP BY cl
49e0: 61 75 73 65 73 20 63 61 75 73 65 73 20 6f 6e 65  auses causes one
49f0: 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66   or more rows of
4a00: 20 74 68 65 20 72 65 73 75 6c 74 20 74 6f 0a 62   the result to.b
4a10: 65 20 63 6f 6d 62 69 6e 65 64 20 69 6e 74 6f 20  e combined into 
4a20: 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f 66 20  a single row of 
4a30: 6f 75 74 70 75 74 2e 20 20 54 68 69 73 20 69 73  output.  This is
4a40: 20 65 73 70 65 63 69 61 6c 6c 79 20 75 73 65 66   especially usef
4a50: 75 6c 0a 77 68 65 6e 20 74 68 65 20 72 65 73 75  ul.when the resu
4a60: 6c 74 20 63 6f 6e 74 61 69 6e 73 20 61 67 67 72  lt contains aggr
4a70: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e  egate functions.
4a80: 20 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e    The expression
4a90: 73 20 69 6e 0a 74 68 65 20 47 52 4f 55 50 20 42  s in.the GROUP B
4aa0: 59 20 63 6c 61 75 73 65 20 64 6f 20 3c 65 6d 3e  Y clause do <em>
4ab0: 6e 6f 74 3c 2f 65 6d 3e 20 68 61 76 65 20 74 6f  not</em> have to
4ac0: 20 62 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20   be expressions 
4ad0: 74 68 61 74 0a 61 70 70 65 61 72 20 69 6e 20 74  that.appear in t
4ae0: 68 65 20 72 65 73 75 6c 74 2e 20 20 54 68 65 20  he result.  The 
4af0: 48 41 56 49 4e 47 20 63 6c 61 75 73 65 20 69 73  HAVING clause is
4b00: 20 73 69 6d 69 6c 61 72 20 74 6f 20 57 48 45 52   similar to WHER
4b10: 45 20 65 78 63 65 70 74 0a 74 68 61 74 20 48 41  E except.that HA
4b20: 56 49 4e 47 20 61 70 70 6c 69 65 73 20 61 66 74  VING applies aft
4b30: 65 72 20 67 72 6f 75 70 69 6e 67 20 68 61 73 20  er grouping has 
4b40: 6f 63 63 75 72 72 65 64 2e 20 20 54 68 65 20 48  occurred.  The H
4b50: 41 56 49 4e 47 20 65 78 70 72 65 73 73 69 6f 6e  AVING expression
4b60: 0a 6d 61 79 20 72 65 66 65 72 20 74 6f 20 76 61  .may refer to va
4b70: 6c 75 65 73 2c 20 65 76 65 6e 20 61 67 67 72 65  lues, even aggre
4b80: 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20  gate functions, 
4b90: 74 68 61 74 20 61 72 65 20 6e 6f 74 20 69 6e 20  that are not in 
4ba0: 74 68 65 20 72 65 73 75 6c 74 2e 3c 2f 70 3e 0a  the result.</p>.
4bb0: 0a 3c 70 3e 54 68 65 20 4f 52 44 45 52 20 42 59  .<p>The ORDER BY
4bc0: 20 63 6c 61 75 73 65 20 63 61 75 73 65 73 20 74   clause causes t
4bd0: 68 65 20 6f 75 74 70 75 74 20 72 6f 77 73 20 74  he output rows t
4be0: 6f 20 62 65 20 73 6f 72 74 65 64 2e 20 20 0a 54  o be sorted.  .T
4bf0: 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 4f  he argument to O
4c00: 52 44 45 52 20 42 59 20 69 73 20 61 20 6c 69 73  RDER BY is a lis
4c10: 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e 73  t of expressions
4c20: 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 61   that are used a
4c30: 73 20 74 68 65 0a 6b 65 79 20 66 6f 72 20 74 68  s the.key for th
4c40: 65 20 73 6f 72 74 2e 20 20 54 68 65 20 65 78 70  e sort.  The exp
4c50: 72 65 73 73 69 6f 6e 73 20 64 6f 20 6e 6f 74 20  ressions do not 
4c60: 68 61 76 65 20 74 6f 20 62 65 20 70 61 72 74 20  have to be part 
4c70: 6f 66 20 74 68 65 0a 72 65 73 75 6c 74 20 66 6f  of the.result fo
4c80: 72 20 61 20 73 69 6d 70 6c 65 20 53 45 4c 45 43  r a simple SELEC
4c90: 54 2c 20 62 75 74 20 69 6e 20 61 20 63 6f 6d 70  T, but in a comp
4ca0: 6f 75 6e 64 20 53 45 4c 45 43 54 20 65 61 63 68  ound SELECT each
4cb0: 20 73 6f 72 74 0a 65 78 70 72 65 73 73 69 6f 6e   sort.expression
4cc0: 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d 61   must exactly ma
4cd0: 74 63 68 20 6f 6e 65 20 6f 66 20 74 68 65 20 72  tch one of the r
4ce0: 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20 20  esult columns.  
4cf0: 45 61 63 68 0a 73 6f 72 74 20 65 78 70 72 65 73  Each.sort expres
4d00: 73 69 6f 6e 20 6d 61 79 20 62 65 20 6f 70 74 69  sion may be opti
4d10: 6f 6e 61 6c 6c 79 20 66 6f 6c 6c 6f 77 65 64 20  onally followed 
4d20: 62 79 20 41 53 43 20 6f 72 20 44 45 53 43 20 74  by ASC or DESC t
4d30: 6f 20 73 70 65 63 69 66 79 0a 74 68 65 20 73 6f  o specify.the so
4d40: 72 74 20 6f 72 64 65 72 2e 3c 2f 70 3e 0a 0a 3c  rt order.</p>..<
4d50: 70 3e 41 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c  p>A compound SEL
4d60: 45 43 54 20 69 73 20 66 6f 72 6d 65 64 20 66 72  ECT is formed fr
4d70: 6f 6d 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 73  om two or more s
4d80: 69 6d 70 6c 65 20 53 45 4c 45 43 54 73 20 63 6f  imple SELECTs co
4d90: 6e 6e 65 63 74 65 64 0a 62 79 20 6f 6e 65 20 6f  nnected.by one o
4da0: 66 20 74 68 65 20 6f 70 65 72 61 74 6f 72 73 20  f the operators 
4db0: 55 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c  UNION, UNION ALL
4dc0: 2c 20 49 4e 54 45 52 53 45 43 54 2c 20 6f 72 20  , INTERSECT, or 
4dd0: 45 58 43 45 50 54 2e 20 20 49 6e 0a 61 20 63 6f  EXCEPT.  In.a co
4de0: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2c 20 61  mpound SELECT, a
4df0: 6c 6c 20 74 68 65 20 63 6f 6e 73 74 69 74 75 65  ll the constitue
4e00: 6e 74 20 53 45 4c 45 43 54 73 20 6d 75 73 74 20  nt SELECTs must 
4e10: 73 70 65 63 69 66 79 20 74 68 65 0a 73 61 6d 65  specify the.same
4e20: 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c   number of resul
4e30: 74 20 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 72  t columns.  Ther
4e40: 65 20 6d 61 79 20 62 65 20 6f 6e 6c 79 20 61 20  e may be only a 
4e50: 73 69 6e 67 6c 65 20 4f 52 44 45 52 20 42 59 0a  single ORDER BY.
4e60: 63 6c 61 75 73 65 20 61 74 20 74 68 65 20 65 6e  clause at the en
4e70: 64 20 6f 66 20 74 68 65 20 63 6f 6d 70 6f 75 6e  d of the compoun
4e80: 64 20 53 45 4c 45 43 54 2e 20 20 54 68 65 20 55  d SELECT.  The U
4e90: 4e 49 4f 4e 20 61 6e 64 20 55 4e 49 4f 4e 20 41  NION and UNION A
4ea0: 4c 4c 0a 6f 70 65 72 61 74 6f 72 73 20 63 6f 6d  LL.operators com
4eb0: 62 69 6e 65 20 74 68 65 20 72 65 73 75 6c 74 73  bine the results
4ec0: 20 6f 66 20 74 68 65 20 53 45 4c 45 43 54 73 20   of the SELECTs 
4ed0: 74 6f 20 74 68 65 20 72 69 67 68 74 20 61 6e 64  to the right and
4ee0: 20 6c 65 66 74 20 69 6e 74 6f 0a 61 20 73 69 6e   left into.a sin
4ef0: 67 6c 65 20 62 69 67 20 74 61 62 6c 65 2e 20 20  gle big table.  
4f00: 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 69  The difference i
4f10: 73 20 74 68 61 74 20 69 6e 20 55 4e 49 4f 4e 20  s that in UNION 
4f20: 61 6c 6c 20 72 65 73 75 6c 74 20 72 6f 77 73 0a  all result rows.
4f30: 61 72 65 20 64 69 73 74 69 6e 63 74 20 77 68 65  are distinct whe
4f40: 72 65 20 69 6e 20 55 4e 49 4f 4e 20 41 4c 4c 20  re in UNION ALL 
4f50: 74 68 65 72 65 20 6d 61 79 20 62 65 20 64 75 70  there may be dup
4f60: 6c 69 63 61 74 65 73 2e 0a 54 68 65 20 49 4e 54  licates..The INT
4f70: 45 52 53 45 43 54 20 6f 70 65 72 61 74 6f 72 20  ERSECT operator 
4f80: 74 61 6b 65 73 20 74 68 65 20 69 6e 74 65 72 73  takes the inters
4f90: 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 72 65  ection of the re
4fa0: 73 75 6c 74 73 20 6f 66 20 74 68 65 0a 6c 65 66  sults of the.lef
4fb0: 74 20 61 6e 64 20 72 69 67 68 74 20 53 45 4c 45  t and right SELE
4fc0: 43 54 73 2e 20 20 45 58 43 45 50 54 20 74 61 6b  CTs.  EXCEPT tak
4fd0: 65 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  es the result of
4fe0: 20 6c 65 66 74 20 53 45 4c 45 43 54 20 61 66 74   left SELECT aft
4ff0: 65 72 0a 72 65 6d 6f 76 69 6e 67 20 74 68 65 20  er.removing the 
5000: 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 72  results of the r
5010: 69 67 68 74 20 53 45 4c 45 43 54 2e 20 20 57 68  ight SELECT.  Wh
5020: 65 6e 20 74 68 72 65 65 20 61 72 65 20 6d 6f 72  en three are mor
5030: 65 20 53 45 4c 45 43 54 73 0a 61 72 65 20 63 6f  e SELECTs.are co
5040: 6e 6e 65 63 74 65 64 20 69 6e 74 6f 20 61 20 63  nnected into a c
5050: 6f 6d 70 6f 75 6e 64 2c 20 74 68 65 79 20 67 72  ompound, they gr
5060: 6f 75 70 20 66 72 6f 6d 20 6c 65 66 74 20 74 6f  oup from left to
5070: 20 72 69 67 68 74 2e 3c 2f 70 3e 0a 7d 0a 0a 53   right.</p>.}..S
5080: 65 63 74 69 6f 6e 20 55 50 44 41 54 45 20 75 70  ection UPDATE up
5090: 64 61 74 65 0a 0a 53 79 6e 74 61 78 20 7b 73 71  date..Syntax {sq
50a0: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 55  l-statement} {.U
50b0: 50 44 41 54 45 20 3c 74 61 62 6c 65 2d 6e 61 6d  PDATE <table-nam
50c0: 65 3e 20 53 45 54 20 3c 61 73 73 69 67 6e 6d 65  e> SET <assignme
50d0: 6e 74 3e 20 5b 2c 20 3c 61 73 73 69 67 6e 6d 65  nt> [, <assignme
50e0: 6e 74 3e 5d 20 5b 57 48 45 52 45 20 3c 65 78 70  nt>] [WHERE <exp
50f0: 72 65 73 73 69 6f 6e 3e 5d 0a 7d 20 7b 61 73 73  ression>].} {ass
5100: 69 67 6e 6d 65 6e 74 7d 20 7b 0a 3c 63 6f 6c 75  ignment} {.<colu
5110: 6d 6e 2d 6e 61 6d 65 3e 20 3d 20 3c 65 78 70 72  mn-name> = <expr
5120: 65 73 73 69 6f 6e 3e 0a 7d 0a 0a 70 75 74 73 20  ession>.}..puts 
5130: 7b 0a 3c 70 3e 54 68 65 20 55 50 44 41 54 45 20  {.<p>The UPDATE 
5140: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 75 73 65  statement is use
5150: 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20  d to change the 
5160: 76 61 6c 75 65 20 6f 66 20 63 6f 6c 75 6d 6e 73  value of columns
5170: 20 69 6e 20 0a 73 65 6c 65 63 74 65 64 20 72 6f   in .selected ro
5180: 77 73 20 6f 66 20 61 20 74 61 62 6c 65 2e 20 20  ws of a table.  
5190: 45 61 63 68 20 61 73 73 69 67 6e 6d 65 6e 74 20  Each assignment 
51a0: 69 6e 20 61 6e 20 55 50 44 41 54 45 20 73 70 65  in an UPDATE spe
51b0: 63 69 66 69 65 73 0a 61 20 63 6f 6c 75 6d 6e 20  cifies.a column 
51c0: 6e 61 6d 65 20 74 6f 20 74 68 65 20 6c 65 66 74  name to the left
51d0: 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73 20 73   of the equals s
51e0: 69 67 6e 20 61 6e 64 20 61 6e 20 61 72 62 69 74  ign and an arbit
51f0: 72 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e 0a  rary expression.
5200: 74 6f 20 74 68 65 20 72 69 67 68 74 2e 20 20 54  to the right.  T
5210: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 6d  he expressions m
5220: 61 79 20 75 73 65 20 74 68 65 20 76 61 6c 75 65  ay use the value
5230: 73 20 6f 66 20 6f 74 68 65 72 20 63 6f 6c 75 6d  s of other colum
5240: 6e 73 2e 0a 41 6c 6c 20 65 78 70 72 65 73 73 69  ns..All expressi
5250: 6f 6e 73 20 61 72 65 20 65 76 61 6c 75 61 74 65  ons are evaluate
5260: 64 20 62 65 66 6f 72 65 20 61 6e 79 20 61 73 73  d before any ass
5270: 69 67 6e 6d 65 6e 74 73 20 61 72 65 20 6d 61 64  ignments are mad
5280: 65 2e 0a 41 20 57 48 45 52 45 20 63 6c 61 75 73  e..A WHERE claus
5290: 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  e can be used to
52a0: 20 72 65 73 74 72 69 63 74 20 77 68 69 63 68 20   restrict which 
52b0: 72 6f 77 73 20 61 72 65 20 75 70 64 61 74 65 64  rows are updated
52c0: 2e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 56 41 43  ..}..Section VAC
52d0: 55 55 4d 20 76 61 63 75 75 6d 0a 0a 53 79 6e 74  UUM vacuum..Synt
52e0: 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e  ax {sql-statemen
52f0: 74 7d 20 7b 0a 56 41 43 55 55 4d 20 5b 3c 69 6e  t} {.VACUUM [<in
5300: 64 65 78 2d 6f 72 2d 74 61 62 6c 65 2d 6e 61 6d  dex-or-table-nam
5310: 65 3e 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  e>].}..puts {.<p
5320: 3e 54 68 65 20 56 41 43 55 55 4d 20 63 6f 6d 6d  >The VACUUM comm
5330: 61 6e 64 20 69 73 20 61 6e 20 53 51 4c 69 74 65  and is an SQLite
5340: 20 65 78 74 65 6e 73 69 6f 6e 20 6d 6f 64 65 6c   extension model
5350: 6c 65 64 20 61 66 74 65 72 20 61 20 73 69 6d 69  led after a simi
5360: 6c 61 72 0a 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e  lar.command foun
5370: 64 20 69 6e 20 50 6f 73 74 67 72 65 53 51 4c 2e  d in PostgreSQL.
5380: 20 20 49 66 20 56 41 43 55 55 4d 20 69 73 20 69    If VACUUM is i
5390: 6e 76 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20  nvoked with the 
53a0: 6e 61 6d 65 20 6f 66 20 61 0a 74 61 62 6c 65 20  name of a.table 
53b0: 6f 72 20 69 6e 64 65 78 20 74 68 65 6e 20 69 74  or index then it
53c0: 20 69 73 20 73 75 70 70 6f 73 65 20 74 6f 20 63   is suppose to c
53d0: 6c 65 61 6e 20 75 70 20 74 68 65 20 6e 61 6d 65  lean up the name
53e0: 64 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78  d table or index
53f0: 2e 0a 49 6e 20 76 65 72 73 69 6f 6e 20 31 2e 30  ..In version 1.0
5400: 20 6f 66 20 53 51 4c 69 74 65 2c 20 74 68 65 20   of SQLite, the 
5410: 56 41 43 55 55 4d 20 63 6f 6d 6d 61 6e 64 20 77  VACUUM command w
5420: 6f 75 6c 64 20 69 6e 76 6f 6b 65 20 0a 3c 62 3e  ould invoke .<b>
5430: 67 64 62 6d 5f 72 65 6f 72 67 61 6e 69 7a 65 28  gdbm_reorganize(
5440: 29 3c 2f 62 3e 20 74 6f 20 63 6c 65 61 6e 20 75  )</b> to clean u
5450: 70 20 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61  p the backend da
5460: 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 42 65 67  tabase file..Beg
5470: 69 6e 6e 69 6e 67 20 77 69 74 68 20 76 65 72 73  inning with vers
5480: 69 6f 6e 20 32 2e 30 20 6f 66 20 53 51 4c 69 74  ion 2.0 of SQLit
5490: 65 2c 20 47 44 42 4d 20 69 73 20 6e 6f 20 6c 6f  e, GDBM is no lo
54a0: 6e 67 65 72 20 75 73 65 64 20 66 6f 72 0a 74 68  nger used for.th
54b0: 65 20 64 61 74 61 62 61 73 65 20 62 61 63 6b 65  e database backe
54c0: 6e 64 20 61 6e 64 20 56 41 43 55 55 4d 20 68 61  nd and VACUUM ha
54d0: 73 20 62 65 63 6f 6d 65 20 61 20 6e 6f 2d 6f 70  s become a no-op
54e0: 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f  ..</p>.}..Sectio
54f0: 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d 61 0a  n PRAGMA pragma.
5500: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61  .Syntax {sql-sta
5510: 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47 4d 41  tement} {.PRAGMA
5520: 20 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c 75 65   <name> = <value
5530: 3e 20 7c 0a 50 52 41 47 4d 41 20 3c 66 75 6e 63  > |.PRAGMA <func
5540: 74 69 6f 6e 3e 28 3c 61 72 67 3e 29 0a 7d 0a 0a  tion>(<arg>).}..
5550: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 50 52  puts {.<p>The PR
5560: 41 47 4d 41 20 63 6f 6d 6d 61 6e 64 20 69 73 20  AGMA command is 
5570: 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 74  used to modify t
5580: 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20  he operation of 
5590: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
55a0: 72 79 2e 0a 54 68 65 20 70 72 61 67 6d 61 20 63  ry..The pragma c
55b0: 6f 6d 6d 61 6e 64 20 69 73 20 65 78 70 65 72 69  ommand is experi
55c0: 6d 65 6e 74 61 6c 20 61 6e 64 20 73 70 65 63 69  mental and speci
55d0: 66 69 63 20 70 72 61 67 6d 61 20 73 74 61 74 65  fic pragma state
55e0: 6d 65 6e 74 73 20 6d 61 79 0a 72 65 6d 6f 76 65  ments may.remove
55f0: 64 20 6f 72 20 61 64 64 65 64 20 69 6e 20 66 75  d or added in fu
5600: 74 75 72 65 20 72 65 6c 65 61 73 65 73 20 6f 66  ture releases of
5610: 20 53 51 4c 69 74 65 2e 20 20 55 73 65 20 74 68   SQLite.  Use th
5620: 69 73 20 63 6f 6d 6d 61 6e 64 0a 77 69 74 68 20  is command.with 
5630: 63 61 75 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70  caution.</p>..<p
5640: 3e 54 68 65 20 63 75 72 72 65 6e 74 20 69 6d 70  >The current imp
5650: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 75 70 70  lementation supp
5660: 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69  orts the followi
5670: 6e 67 20 70 72 61 67 6d 61 73 3a 3c 2f 70 3e 0a  ng pragmas:</p>.
5680: 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  .<ul>.<li><p><b>
5690: 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69 7a  PRAGMA cache_siz
56a0: 65 20 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d 62 65  e = </b><i>Numbe
56b0: 72 2d 6f 66 2d 70 61 67 65 73 3c 2f 69 3e 3c 62  r-of-pages</i><b
56c0: 3e 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c  >;</b></p>.    <
56d0: 70 3e 43 68 61 6e 67 65 20 74 68 65 20 6d 61 78  p>Change the max
56e0: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 64  imum number of d
56f0: 61 74 61 62 61 73 65 20 64 69 73 6b 20 70 61 67  atabase disk pag
5700: 65 73 20 74 68 61 74 20 53 51 4c 69 74 65 0a 20  es that SQLite. 
5710: 20 20 20 77 69 6c 6c 20 68 6f 6c 64 20 69 6e 20     will hold in 
5720: 6d 65 6d 6f 72 79 20 61 74 20 6f 6e 63 65 2e 20  memory at once. 
5730: 20 45 61 63 68 20 70 61 67 65 20 75 73 65 73 20   Each page uses 
5740: 61 62 6f 75 74 20 31 2e 35 4b 20 6f 66 20 52 41  about 1.5K of RA
5750: 4d 2e 0a 20 20 20 20 54 68 65 20 64 65 66 61 75  M..    The defau
5760: 6c 74 20 63 61 63 68 65 20 73 69 7a 65 20 69 73  lt cache size is
5770: 20 31 30 30 2e 20 20 49 66 20 79 6f 75 20 61 72   100.  If you ar
5780: 65 20 64 6f 69 6e 67 20 55 50 44 41 54 45 73 20  e doing UPDATEs 
5790: 6f 72 20 44 45 4c 45 54 45 73 0a 20 20 20 20 74  or DELETEs.    t
57a0: 68 61 74 20 63 68 61 6e 67 65 20 6d 61 6e 79 20  hat change many 
57b0: 72 6f 77 73 20 6f 66 20 61 20 64 61 74 61 62 61  rows of a databa
57c0: 73 65 20 61 6e 64 20 79 6f 75 20 64 6f 20 6e 6f  se and you do no
57d0: 74 20 6d 69 6e 64 20 69 66 20 53 51 4c 69 74 65  t mind if SQLite
57e0: 0a 20 20 20 20 75 73 65 73 20 6d 6f 72 65 20 6d  .    uses more m
57f0: 65 6d 6f 72 79 2c 20 79 6f 75 20 63 61 6e 20 69  emory, you can i
5800: 6e 63 72 65 61 73 65 20 74 68 65 20 63 61 63 68  ncrease the cach
5810: 65 20 73 69 7a 65 20 66 6f 72 20 61 20 70 6f 73  e size for a pos
5820: 73 69 62 6c 65 20 73 70 65 65 64 0a 20 20 20 20  sible speed.    
5830: 69 6d 70 72 6f 76 65 6d 65 6e 74 2e 3c 2f 70 3e  improvement.</p>
5840: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  </li>..<li><p><b
5850: 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f 63 68  >PRAGMA count_ch
5860: 61 6e 67 65 73 20 3d 20 4f 4e 3b 0a 20 20 20 20  anges = ON;.    
5870: 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 63 6f     <br>PRAGMA co
5880: 75 6e 74 5f 63 68 61 6e 67 65 73 20 3d 20 4f 46  unt_changes = OF
5890: 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c  F;</b></p>.    <
58a0: 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68 65 20 43  p>When on, the C
58b0: 4f 55 4e 54 5f 43 48 41 4e 47 45 53 20 70 72 61  OUNT_CHANGES pra
58c0: 67 6d 61 20 63 61 75 73 65 73 20 74 68 65 20 63  gma causes the c
58d0: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e  allback function
58e0: 20 74 6f 0a 20 20 20 20 62 65 20 69 6e 76 6f 6b   to.    be invok
58f0: 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68  ed once for each
5900: 20 44 45 4c 45 54 45 2c 20 49 4e 53 45 52 54 2c   DELETE, INSERT,
5910: 20 6f 72 20 55 50 44 41 54 45 20 6f 70 65 72 61   or UPDATE opera
5920: 74 69 6f 6e 2e 20 20 54 68 65 0a 20 20 20 20 61  tion.  The.    a
5930: 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 6e  rgument is the n
5940: 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 74 68  umber of rows th
5950: 61 74 20 77 65 72 65 20 63 68 61 6e 67 65 64 2e  at were changed.
5960: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
5970: 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f 6c 75  PRAGMA full_colu
5980: 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 4e 3b 0a 20  mn_names = ON;. 
5990: 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41        <br>PRAGMA
59a0: 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d   full_column_nam
59b0: 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70  es = OFF;</b></p
59c0: 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f 6c  >.    <p>The col
59d0: 75 6d 6e 20 6e 61 6d 65 73 20 72 65 70 6f 72 74  umn names report
59e0: 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65 20  ed in an SQLite 
59f0: 63 61 6c 6c 62 61 63 6b 20 61 72 65 20 6e 6f 72  callback are nor
5a00: 6d 61 6c 6c 79 20 6a 75 73 74 0a 20 20 20 20 74  mally just.    t
5a10: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63  he name of the c
5a20: 6f 6c 75 6d 6e 20 69 74 73 65 6c 66 2c 20 65 78  olumn itself, ex
5a30: 63 65 70 74 20 66 6f 72 20 6a 6f 69 6e 73 20 77  cept for joins w
5a40: 68 65 6e 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d  hen "TABLE.COLUM
5a50: 4e 22 0a 20 20 20 20 69 73 20 75 73 65 64 2e 20  N".    is used. 
5a60: 20 42 75 74 20 77 68 65 6e 20 66 75 6c 6c 5f 63   But when full_c
5a70: 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 69 73 20 74  olumn_names is t
5a80: 75 72 6e 65 64 20 6f 6e 2c 20 63 6f 6c 75 6d 6e  urned on, column
5a90: 20 6e 61 6d 65 73 20 61 72 65 0a 20 20 20 20 61   names are.    a
5aa0: 6c 77 61 79 73 20 72 65 70 6f 72 74 65 64 20 61  lways reported a
5ab0: 73 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 22  s "TABLE.COLUMN"
5ac0: 20 65 76 65 6e 20 66 6f 72 20 73 69 6d 70 6c 65   even for simple
5ad0: 20 71 75 65 72 69 65 73 2e 3c 2f 70 3e 3c 2f 6c   queries.</p></l
5ae0: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52  i>..<li><p><b>PR
5af0: 41 47 4d 41 20 69 6e 64 65 78 5f 69 6e 66 6f 28  AGMA index_info(
5b00: 3c 2f 62 3e 3c 69 3e 69 6e 64 65 78 2d 6e 61 6d  </b><i>index-nam
5b10: 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f  e</i><b>);</b></
5b20: 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61  p>.    <p>For ea
5b30: 63 68 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74  ch column that t
5b40: 68 65 20 6e 61 6d 65 64 20 69 6e 64 65 78 20 72  he named index r
5b50: 65 66 65 72 65 6e 63 65 73 2c 20 69 6e 76 6f 6b  eferences, invok
5b60: 65 20 74 68 65 20 0a 20 20 20 20 63 61 6c 6c 62  e the .    callb
5b70: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20  ack function.   
5b80: 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72   once with infor
5b90: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61  mation about tha
5ba0: 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64  t column, includ
5bb0: 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e  ing the column n
5bc0: 61 6d 65 2c 0a 20 20 20 20 61 6e 64 20 74 68 65  ame,.    and the
5bd0: 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 2e 3c   column number.<
5be0: 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50  /p>..<li><p><b>P
5bf0: 52 41 47 4d 41 20 69 6e 64 65 78 5f 6c 69 73 74  RAGMA index_list
5c00: 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61  (</b><i>table-na
5c10: 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c  me</i><b>);</b><
5c20: 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65  /p>.    <p>For e
5c30: 61 63 68 20 69 6e 64 65 78 20 6f 6e 20 74 68 65  ach index on the
5c40: 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e   named table, in
5c50: 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63  voke the callbac
5c60: 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f  k function.    o
5c70: 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61  nce with informa
5c80: 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20  tion about that 
5c90: 69 6e 64 65 78 2e 20 20 41 72 67 75 6d 65 6e 74  index.  Argument
5ca0: 73 20 69 6e 63 6c 75 64 65 20 74 68 65 0a 20 20  s include the.  
5cb0: 20 20 69 6e 64 65 78 20 6e 61 6d 65 20 61 6e 64    index name and
5cc0: 20 61 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 63   a flag to indic
5cd0: 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e  ate whether or n
5ce0: 6f 74 20 74 68 65 20 69 6e 64 65 78 20 6d 75 73  ot the index mus
5cf0: 74 20 62 65 0a 20 20 20 20 75 6e 69 71 75 65 2e  t be.    unique.
5d00: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
5d10: 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72  PRAGMA parser_tr
5d20: 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41  ace = ON;<br>PRA
5d30: 47 4d 41 20 70 61 72 73 65 72 5f 74 72 61 63 65  GMA parser_trace
5d40: 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a   = OFF;</b></p>.
5d50: 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61 63      <p>Turn trac
5d60: 69 6e 67 20 6f 66 20 74 68 65 20 53 51 4c 20 70  ing of the SQL p
5d70: 61 72 73 65 72 20 69 6e 73 69 64 65 20 6f 66 20  arser inside of 
5d80: 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c  the.    SQLite l
5d90: 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66  ibrary on and of
5da0: 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  f.  This is used
5db0: 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 0a   for debugging..
5dc0: 20 20 20 20 54 68 69 73 20 6f 6e 6c 79 20 77 6f      This only wo
5dd0: 72 6b 73 20 69 66 20 74 68 65 20 6c 69 62 72 61  rks if the libra
5de0: 72 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77  ry is compiled w
5df0: 69 74 68 6f 75 74 20 74 68 65 20 4e 44 45 42 55  ithout the NDEBU
5e00: 47 20 6d 61 63 72 6f 2e 0a 20 20 20 20 3c 2f 70  G macro..    </p
5e10: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c  ></li>..<li><p><
5e20: 62 3e 50 52 41 47 4d 41 20 74 61 62 6c 65 5f 69  b>PRAGMA table_i
5e30: 6e 66 6f 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65  nfo(</b><i>table
5e40: 2d 6e 61 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f  -name</i><b>);</
5e50: 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f  b></p>.    <p>Fo
5e60: 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 69 6e  r each column in
5e70: 20 74 68 65 20 6e 61 6d 65 64 20 74 61 62 6c 65   the named table
5e80: 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c  , invoke the cal
5e90: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20  lback function. 
5ea0: 20 20 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66     once with inf
5eb0: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74  ormation about t
5ec0: 68 61 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c  hat column, incl
5ed0: 75 64 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e  uding the column
5ee0: 20 6e 61 6d 65 2c 0a 20 20 20 20 64 61 74 61 20   name,.    data 
5ef0: 74 79 70 65 2c 20 77 68 65 74 68 65 72 20 6f 72  type, whether or
5f00: 20 6e 6f 74 20 74 68 65 20 63 6f 6c 75 6d 6e 20   not the column 
5f10: 63 61 6e 20 62 65 20 4e 55 4c 4c 2c 20 61 6e 64  can be NULL, and
5f20: 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 20   the default.   
5f30: 20 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20 63   value for the c
5f40: 6f 6c 75 6d 6e 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e  olumn.</p>..<li>
5f50: 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 76 64 62  <p><b>PRAGMA vdb
5f60: 65 5f 74 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72  e_trace = ON;<br
5f70: 3e 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61  >PRAGMA vdbe_tra
5f80: 63 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70  ce = OFF;</b></p
5f90: 3e 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72  >.    <p>Turn tr
5fa0: 61 63 69 6e 67 20 6f 66 20 74 68 65 20 76 69 72  acing of the vir
5fb0: 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 65 6e  tual database en
5fc0: 67 69 6e 65 20 69 6e 73 69 64 65 20 6f 66 20 74  gine inside of t
5fd0: 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c 69  he.    SQLite li
5fe0: 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66 66  brary on and off
5ff0: 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20  .  This is used 
6000: 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 3c 2f  for debugging.</
6010: 70 3e 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c  p></li>.</ul>..<
6020: 70 3e 4e 6f 20 65 72 72 6f 72 20 6d 65 73 73 61  p>No error messa
6030: 67 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 20  ge is generated 
6040: 69 66 20 61 6e 20 75 6e 6b 6e 6f 77 6e 20 70 72  if an unknown pr
6050: 61 67 6d 61 20 69 73 20 69 73 73 75 65 64 2e 0a  agma is issued..
6060: 55 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 73 20  Unknown pragmas 
6070: 61 72 65 20 69 67 6e 6f 72 65 64 2e 3c 2f 70 3e  are ignored.</p>
6080: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 3c 2f  .}..puts {.<p></
6090: 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  p>.}..puts {.<p>
60a0: 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 3c 61  <hr /></p>.<p><a
60b0: 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d   href="index.htm
60c0: 6c 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67 6f  l"><img src="/go
60d0: 62 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65 72  back.jpg" border
60e0: 3d 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74 68  =0 />.Back to th
60f0: 65 20 53 51 4c 69 74 65 20 48 6f 6d 65 20 50 61  e SQLite Home Pa
6100: 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 62  ge</a>.</p>..</b
6110: 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a           ody></html>}.