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

Artifact 7ad595247fd81f394012a0cfd84ccd6241b9e59a:


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 32 30 20 32 30 30 32  .tcl,v 1.20 2002
0060: 2f 30 31 2f 33 31 20 31 35 3a 35 34 3a 32 33 20  /01/31 15:54:23 
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 55 54 43 29 0a 3c 2f 70 3e 22 0a 0a 70 75  ] UTC).</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 73 79 6e 74 61 78 3a  e follow syntax:
0460: 3c 2f 70 3e 0a 3c 70 3e 3c 75 6c 3e 0a 7d 0a 0a  </p>.<p><ul>.}..
0470: 66 6f 72 65 61 63 68 20 7b 73 65 63 74 69 6f 6e  foreach {section
0480: 7d 20 5b 6c 73 6f 72 74 20 2d 69 6e 64 65 78 20  } [lsort -index 
0490: 30 20 2d 64 69 63 74 69 6f 6e 61 72 79 20 7b 0a  0 -dictionary {.
04a0: 20 20 7b 7b 43 52 45 41 54 45 20 54 41 42 4c 45    {{CREATE TABLE
04b0: 7d 20 63 72 65 61 74 65 74 61 62 6c 65 7d 0a 20  } createtable}. 
04c0: 20 7b 7b 43 52 45 41 54 45 20 49 4e 44 45 58 7d   {{CREATE INDEX}
04d0: 20 63 72 65 61 74 65 69 6e 64 65 78 7d 0a 20 20   createindex}.  
04e0: 7b 56 41 43 55 55 4d 20 76 61 63 75 75 6d 7d 0a  {VACUUM vacuum}.
04f0: 20 20 7b 7b 44 52 4f 50 20 54 41 42 4c 45 7d 20    {{DROP TABLE} 
0500: 64 72 6f 70 74 61 62 6c 65 7d 0a 20 20 7b 7b 44  droptable}.  {{D
0510: 52 4f 50 20 49 4e 44 45 58 7d 20 64 72 6f 70 69  ROP INDEX} dropi
0520: 6e 64 65 78 7d 0a 20 20 7b 49 4e 53 45 52 54 20  ndex}.  {INSERT 
0530: 69 6e 73 65 72 74 7d 0a 20 20 7b 44 45 4c 45 54  insert}.  {DELET
0540: 45 20 64 65 6c 65 74 65 7d 0a 20 20 7b 55 50 44  E delete}.  {UPD
0550: 41 54 45 20 75 70 64 61 74 65 7d 0a 20 20 7b 53  ATE update}.  {S
0560: 45 4c 45 43 54 20 73 65 6c 65 63 74 7d 0a 20 20  ELECT select}.  
0570: 7b 43 4f 50 59 20 63 6f 70 79 7d 0a 20 20 7b 45  {COPY copy}.  {E
0580: 58 50 4c 41 49 4e 20 65 78 70 6c 61 69 6e 7d 0a  XPLAIN explain}.
0590: 20 20 7b 65 78 70 72 65 73 73 69 6f 6e 20 65 78    {expression ex
05a0: 70 72 7d 0a 20 20 7b 7b 42 45 47 49 4e 20 54 52  pr}.  {{BEGIN TR
05b0: 41 4e 53 41 43 54 49 4f 4e 7d 20 74 72 61 6e 73  ANSACTION} trans
05c0: 61 63 74 69 6f 6e 7d 0a 20 20 7b 50 52 41 47 4d  action}.  {PRAGM
05d0: 41 20 70 72 61 67 6d 61 7d 0a 20 20 7b 7b 4f 4e  A pragma}.  {{ON
05e0: 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65   CONFLICT clause
05f0: 7d 20 63 6f 6e 66 6c 69 63 74 7d 0a 7d 5d 20 7b  } conflict}.}] {
0600: 0a 20 20 70 75 74 73 20 22 3c 6c 69 3e 3c 61 20  .  puts "<li><a 
0610: 68 72 65 66 3d 5c 22 23 5b 6c 69 6e 64 65 78 20  href=\"#[lindex 
0620: 24 73 65 63 74 69 6f 6e 20 31 5d 5c 22 3e 5b 6c  $section 1]\">[l
0630: 69 6e 64 65 78 20 24 73 65 63 74 69 6f 6e 20 30  index $section 0
0640: 5d 3c 2f 61 3e 3c 2f 6c 69 3e 22 0a 7d 0a 70 75  ]</a></li>".}.pu
0650: 74 73 20 7b 3c 2f 75 6c 3e 3c 2f 70 3e 0a 0a 3c  ts {</ul></p>..<
0660: 70 3e 44 65 74 61 69 6c 73 20 6f 6e 20 74 68 65  p>Details on the
0670: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
0680: 6f 66 20 65 61 63 68 20 63 6f 6d 6d 61 6e 64 20  of each command 
0690: 61 72 65 20 70 72 6f 76 69 64 65 64 20 69 6e 0a  are provided in.
06a0: 74 68 65 20 73 65 71 75 65 6c 2e 3c 2f 70 3e 0a  the sequel.</p>.
06b0: 7d 0a 0a 70 72 6f 63 20 53 79 6e 74 61 78 20 7b  }..proc Syntax {
06c0: 61 72 67 73 7d 20 7b 0a 20 20 70 75 74 73 20 7b  args} {.  puts {
06d0: 3c 74 61 62 6c 65 20 63 65 6c 6c 70 61 64 64 69  <table cellpaddi
06e0: 6e 67 3d 22 31 35 22 3e 7d 0a 20 20 66 6f 72 65  ng="15">}.  fore
06f0: 61 63 68 20 7b 72 75 6c 65 20 62 6f 64 79 7d 20  ach {rule body} 
0700: 24 61 72 67 73 20 7b 0a 20 20 20 20 70 75 74 73  $args {.    puts
0710: 20 22 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d   "<tr><td align=
0720: 5c 22 72 69 67 68 74 5c 22 20 76 61 6c 69 67 6e  \"right\" valign
0730: 3d 5c 22 74 6f 70 5c 22 3e 22 0a 20 20 20 20 70  =\"top\">".    p
0740: 75 74 73 20 22 3c 69 3e 3c 66 6f 6e 74 20 63 6f  uts "<i><font co
0750: 6c 6f 72 3d 5c 22 23 66 66 33 34 33 34 5c 22 3e  lor=\"#ff3434\">
0760: 24 72 75 6c 65 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e  $rule</font></i>
0770: 26 6e 62 73 70 3b 3a 3a 3d 3c 2f 74 64 3e 22 0a  &nbsp;::=</td>".
0780: 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20      regsub -all 
0790: 3c 20 24 62 6f 64 79 20 7b 25 4c 54 7d 20 62 6f  < $body {%LT} bo
07a0: 64 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61  dy.    regsub -a
07b0: 6c 6c 20 3e 20 24 62 6f 64 79 20 7b 25 47 54 7d  ll > $body {%GT}
07c0: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
07d0: 20 2d 61 6c 6c 20 25 4c 54 20 24 62 6f 64 79 20   -all %LT $body 
07e0: 7b 3c 2f 66 6f 6e 74 3e 3c 2f 62 3e 3c 69 3e 3c  {</font></b><i><
07f0: 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 66 66 33  font color="#ff3
0800: 34 33 34 22 3e 7d 20 62 6f 64 79 0a 20 20 20 20  434">} body.    
0810: 72 65 67 73 75 62 20 2d 61 6c 6c 20 25 47 54 20  regsub -all %GT 
0820: 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f  $body {</font></
0830: 69 3e 3c 62 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72  i><b><font color
0840: 3d 22 23 32 63 32 63 66 30 22 3e 7d 20 62 6f 64  ="#2c2cf0">} bod
0850: 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c  y.    regsub -al
0860: 6c 20 7b 5b 5d 7c 5b 2a 3f 5d 7d 20 24 62 6f 64  l {[]|[*?]} $bod
0870: 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f 62 3e 26 3c  y {</font></b>&<
0880: 62 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23  b><font color="#
0890: 32 63 32 63 66 30 22 3e 7d 20 62 6f 64 79 0a 20  2c2cf0">} body. 
08a0: 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 22     regsub -all "
08b0: 5c 6e 22 20 5b 73 74 72 69 6e 67 20 74 72 69 6d  \n" [string trim
08c0: 20 24 62 6f 64 79 5d 20 22 3c 62 72 3e 5c 6e 22   $body] "<br>\n"
08d0: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
08e0: 20 2d 61 6c 6c 20 22 5c 6e 20 20 2a 22 20 24 62   -all "\n  *" $b
08f0: 6f 64 79 20 22 5c 6e 5c 5c 26 6e 62 73 70 3b 5c  ody "\n\\&nbsp;\
0900: 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70 3b 5c  \&nbsp;\\&nbsp;\
0910: 5c 26 6e 62 73 70 3b 22 20 62 6f 64 79 0a 20 20  \&nbsp;" body.  
0920: 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 5b    regsub -all {[
0930: 7c 2c 2e 2a 28 29 5d 7d 20 24 62 6f 64 79 20 7b  |,.*()]} $body {
0940: 3c 62 69 67 3e 26 3c 2f 62 69 67 3e 7d 20 62 6f  <big>&</big>} bo
0950: 64 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61  dy.    regsub -a
0960: 6c 6c 20 7b 20 3d 20 7d 20 24 62 6f 64 79 20 7b  ll { = } $body {
0970: 20 3c 62 69 67 3e 3d 3c 2f 62 69 67 3e 20 7d 20   <big>=</big> } 
0980: 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62 20  body.    regsub 
0990: 2d 61 6c 6c 20 7b 53 54 41 52 7d 20 24 62 6f 64  -all {STAR} $bod
09a0: 79 20 7b 3c 62 69 67 3e 2a 3c 2f 62 69 67 3e 7d  y {<big>*</big>}
09b0: 20 62 6f 64 79 0a 20 20 20 20 70 75 74 73 20 22   body.    puts "
09c0: 3c 74 64 3e 3c 62 3e 3c 66 6f 6e 74 20 63 6f 6c  <td><b><font col
09d0: 6f 72 3d 5c 22 23 32 63 32 63 66 30 5c 22 3e 24  or=\"#2c2cf0\">$
09e0: 62 6f 64 79 3c 2f 66 6f 6e 74 3e 3c 2f 62 3e 3c  body</font></b><
09f0: 2f 74 64 3e 3c 2f 74 72 3e 22 0a 20 20 7d 0a 20  /td></tr>".  }. 
0a00: 20 70 75 74 73 20 7b 3c 2f 74 61 62 6c 65 3e 7d   puts {</table>}
0a10: 0a 7d 0a 70 72 6f 63 20 4f 70 65 72 61 74 6f 72  .}.proc Operator
0a20: 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20 72 65 74 75   {name} {.  retu
0a30: 72 6e 20 22 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d  rn "<font color=
0a40: 5c 22 23 32 63 32 63 66 30 5c 22 3e 3c 62 69 67  \"#2c2cf0\"><big
0a50: 3e 24 6e 61 6d 65 3c 2f 62 69 67 3e 3c 2f 66 6f  >$name</big></fo
0a60: 6e 74 3e 22 0a 7d 0a 70 72 6f 63 20 4e 6f 6e 74  nt>".}.proc Nont
0a70: 65 72 6d 69 6e 61 6c 20 7b 6e 61 6d 65 7d 20 7b  erminal {name} {
0a80: 0a 20 20 72 65 74 75 72 6e 20 22 3c 69 3e 3c 66  .  return "<i><f
0a90: 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 66 66 33  ont color=\"#ff3
0aa0: 34 33 34 5c 22 3e 24 6e 61 6d 65 3c 2f 66 6f 6e  434\">$name</fon
0ab0: 74 3e 3c 2f 69 3e 22 0a 7d 0a 70 72 6f 63 20 4b  t></i>".}.proc K
0ac0: 65 79 77 6f 72 64 20 7b 6e 61 6d 65 7d 20 7b 0a  eyword {name} {.
0ad0: 20 20 72 65 74 75 72 6e 20 22 3c 66 6f 6e 74 20    return "<font 
0ae0: 63 6f 6c 6f 72 3d 5c 22 23 32 63 32 63 66 30 5c  color=\"#2c2cf0\
0af0: 22 3e 24 6e 61 6d 65 3c 2f 66 6f 6e 74 3e 22 0a  ">$name</font>".
0b00: 7d 0a 20 0a 0a 70 72 6f 63 20 53 65 63 74 69 6f  }. ..proc Sectio
0b10: 6e 20 7b 6e 61 6d 65 20 7b 6c 61 62 65 6c 20 7b  n {name {label {
0b20: 7d 7d 7d 20 7b 0a 20 20 70 75 74 73 20 22 5c 6e  }}} {.  puts "\n
0b30: 3c 68 72 20 2f 3e 22 0a 20 20 69 66 20 7b 24 6c  <hr />".  if {$l
0b40: 61 62 65 6c 21 3d 22 22 7d 20 7b 0a 20 20 20 20  abel!=""} {.    
0b50: 70 75 74 73 20 22 3c 61 20 6e 61 6d 65 3d 5c 22  puts "<a name=\"
0b60: 24 6c 61 62 65 6c 5c 22 3e 22 0a 20 20 7d 0a 20  $label\">".  }. 
0b70: 20 70 75 74 73 20 22 3c 68 31 3e 24 6e 61 6d 65   puts "<h1>$name
0b80: 3c 2f 68 31 3e 5c 6e 22 0a 7d 0a 0a 70 72 6f 63  </h1>\n".}..proc
0b90: 20 45 78 61 6d 70 6c 65 20 7b 74 65 78 74 7d 20   Example {text} 
0ba0: 7b 0a 20 20 70 75 74 73 20 22 3c 62 6c 6f 63 6b  {.  puts "<block
0bb0: 71 75 6f 74 65 3e 3c 70 72 65 3e 24 74 65 78 74  quote><pre>$text
0bc0: 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f  </pre></blockquo
0bd0: 74 65 3e 22 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20  te>".}..Section 
0be0: 7b 42 45 47 49 4e 20 54 52 41 4e 53 41 43 54 49  {BEGIN TRANSACTI
0bf0: 4f 4e 7d 20 63 72 65 61 74 65 69 6e 64 65 78 0a  ON} createindex.
0c00: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61  .Syntax {sql-sta
0c10: 74 65 6d 65 6e 74 7d 20 7b 0a 42 45 47 49 4e 20  tement} {.BEGIN 
0c20: 5b 54 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e  [TRANSACTION [<n
0c30: 61 6d 65 3e 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20  ame>]].}.Syntax 
0c40: 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20  {sql-statement} 
0c50: 7b 0a 45 4e 44 20 5b 54 52 41 4e 53 41 43 54 49  {.END [TRANSACTI
0c60: 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 53  ON [<name>]].}.S
0c70: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
0c80: 6d 65 6e 74 7d 20 7b 0a 43 4f 4d 4d 49 54 20 5b  ment} {.COMMIT [
0c90: 54 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61  TRANSACTION [<na
0ca0: 6d 65 3e 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b  me>]].}.Syntax {
0cb0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
0cc0: 0a 52 4f 4c 4c 42 41 43 4b 20 5b 54 52 41 4e 53  .ROLLBACK [TRANS
0cd0: 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d  ACTION [<name>]]
0ce0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 42 65  .}..puts {.<p>Be
0cf0: 67 69 6e 6e 69 6e 67 20 69 6e 20 76 65 72 73 69  ginning in versi
0d00: 6f 6e 20 32 2e 30 2c 20 53 51 4c 69 74 65 20 73  on 2.0, SQLite s
0d10: 75 70 70 6f 72 74 73 20 74 72 61 6e 73 61 63 74  upports transact
0d20: 69 6f 6e 73 20 77 69 74 68 0a 72 6f 6c 6c 62 61  ions with.rollba
0d30: 63 6b 20 61 6e 64 20 61 74 6f 6d 69 63 20 63 6f  ck and atomic co
0d40: 6d 6d 69 74 2e 20 20 48 6f 77 65 76 65 72 2c 20  mmit.  However, 
0d50: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 6c 65  only a single le
0d60: 76 65 6c 20 6f 66 0a 74 72 61 6e 73 61 63 74 69  vel of.transacti
0d70: 6f 6e 20 69 73 20 61 6c 6c 6f 77 65 64 2e 20 20  on is allowed.  
0d80: 54 72 61 6e 73 61 63 74 69 6f 6e 73 20 6d 61 79  Transactions may
0d90: 20 6e 6f 74 20 62 65 20 6e 65 73 74 65 64 2e 0a   not be nested..
0da0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4e 6f 20 63 68 61  </p>..<p>.No cha
0db0: 6e 67 65 73 20 63 61 6e 20 62 65 20 6d 61 64 65  nges can be made
0dc0: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65   to the database
0dd0: 20 65 78 63 65 70 74 20 77 69 74 68 69 6e 20 61   except within a
0de0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 41 6e   transaction..An
0df0: 79 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 63  y command that c
0e00: 68 61 6e 67 65 73 20 74 68 65 20 64 61 74 61 62  hanges the datab
0e10: 61 73 65 20 28 62 61 73 69 63 61 6c 6c 79 2c 20  ase (basically, 
0e20: 61 6e 79 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a  any SQL command.
0e30: 6f 74 68 65 72 20 74 68 61 6e 20 53 45 4c 45 43  other than SELEC
0e40: 54 29 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69  T) will automati
0e50: 63 61 6c 6c 79 20 73 74 61 72 74 73 20 61 20 74  cally starts a t
0e60: 72 61 6e 73 61 63 74 69 6f 6e 20 69 66 0a 6f 6e  ransaction if.on
0e70: 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79  e is not already
0e80: 20 69 6e 20 65 66 66 65 63 74 2e 20 20 41 75 74   in effect.  Aut
0e90: 6f 6d 61 74 69 63 61 6c 6c 79 20 73 74 61 72 65  omatically stare
0ea0: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 0a 61  d transactions.a
0eb0: 72 65 20 63 6f 6d 6d 69 74 74 65 64 20 61 74 20  re committed at 
0ec0: 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f  the conclusion o
0ed0: 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 0a 3c  f the command..<
0ee0: 2f 70 3e 0a 0a 3c 70 3e 0a 54 72 61 6e 73 61 63  /p>..<p>.Transac
0ef0: 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 73 74 61  tions can be sta
0f00: 72 74 65 64 20 6d 61 6e 75 61 6c 6c 79 20 75 73  rted manually us
0f10: 69 6e 67 20 74 68 65 20 42 45 47 49 4e 20 54 52  ing the BEGIN TR
0f20: 41 4e 53 41 43 54 49 4f 4e 0a 63 6f 6d 6d 61 6e  ANSACTION.comman
0f30: 64 2e 20 53 75 63 68 20 74 72 61 6e 73 61 63 74  d. Such transact
0f40: 69 6f 6e 73 20 70 65 72 73 69 73 74 20 75 6e 74  ions persist unt
0f50: 69 6c 20 61 20 43 4f 4d 4d 49 54 20 6f 72 20 52  il a COMMIT or R
0f60: 4f 4c 4c 42 41 43 4b 0a 6f 72 20 75 6e 74 69 6c  OLLBACK.or until
0f70: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
0f80: 20 6f 72 20 74 68 65 20 64 61 74 61 62 61 73 65   or the database
0f90: 20 69 73 20 63 6c 6f 73 65 64 2e 20 20 49 66 20   is closed.  If 
0fa0: 61 6e 0a 65 72 72 6f 72 20 69 73 20 65 6e 63 6f  an.error is enco
0fb0: 75 6e 74 65 72 65 64 20 6f 72 20 74 68 65 20 64  untered or the d
0fc0: 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65  atabase is close
0fd0: 64 2c 20 74 68 65 20 74 72 61 6e 73 61 63 74 69  d, the transacti
0fe0: 6f 6e 0a 69 73 20 61 75 74 6f 6d 61 74 69 63 61  on.is automatica
0ff0: 6c 6c 79 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e  lly rolled back.
1000: 20 20 54 68 65 20 45 4e 44 20 54 52 41 4e 53 41    The END TRANSA
1010: 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e 64 20 69 73  CTION command is
1020: 0a 61 20 61 6c 69 61 73 20 66 6f 72 20 43 4f 4d  .a alias for COM
1030: 4d 49 54 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63  MIT..</p>.}..Sec
1040: 74 69 6f 6e 20 7b 4f 4e 20 43 4f 4e 46 4c 49 43  tion {ON CONFLIC
1050: 54 20 63 6c 61 75 73 65 7d 20 63 6f 6e 66 6c 69  T clause} confli
1060: 63 74 0a 0a 53 79 6e 74 61 78 20 7b 63 6f 6e 66  ct..Syntax {conf
1070: 6c 69 63 74 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f  lict-clause} {.O
1080: 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 61 6c 67 6f  N CONFLICT <algo
1090: 72 69 74 68 6d 3e 0a 7d 20 7b 61 6c 67 6f 72 69  rithm>.} {algori
10a0: 74 68 6d 7d 20 7b 0a 41 42 4f 52 54 20 7c 20 49  thm} {.ABORT | I
10b0: 47 4e 4f 52 45 20 7c 20 52 45 50 4c 41 43 45 0a  GNORE | REPLACE.
10c0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
10d0: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
10e0: 75 73 65 20 69 73 20 6e 6f 74 20 61 20 73 65 70  use is not a sep
10f0: 61 72 61 74 65 20 53 51 4c 20 63 6f 6d 6d 61 6e  arate SQL comman
1100: 64 2e 20 20 49 74 20 69 73 20 61 0a 6e 6f 6e 2d  d.  It is a.non-
1110: 73 74 61 6e 64 61 72 64 20 63 6c 61 75 73 65 20  standard clause 
1120: 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72 20  that can appear 
1130: 69 6e 20 6d 61 6e 79 20 6f 74 68 65 72 20 53 51  in many other SQ
1140: 4c 20 63 6f 6d 6d 61 6e 64 73 2e 0a 49 74 20 69  L commands..It i
1150: 73 20 67 69 76 65 6e 20 69 74 73 20 6f 77 6e 20  s given its own 
1160: 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 69 73 20  section in this 
1170: 64 6f 63 75 6d 65 6e 74 20 62 65 63 61 75 73 65  document because
1180: 20 69 74 20 69 73 20 6e 6f 74 0a 70 61 72 74 20   it is not.part 
1190: 6f 66 20 73 74 61 6e 64 61 72 64 20 53 51 4c 20  of standard SQL 
11a0: 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 6d 69  and therefore mi
11b0: 67 68 74 20 6e 6f 74 20 62 65 20 66 61 6d 69 6c  ght not be famil
11c0: 69 61 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  iar.</p>..<p>The
11d0: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
11e0: 75 73 65 20 73 70 65 63 69 66 69 65 73 20 61 6e  use specifies an
11f0: 20 61 6c 67 6f 72 69 74 68 6d 20 75 73 65 64 20   algorithm used 
1200: 74 6f 20 72 65 73 6f 6c 76 65 0a 63 6f 6e 73 74  to resolve.const
1210: 72 61 69 6e 74 20 63 6f 6e 66 6c 69 63 74 73 2e  raint conflicts.
1220: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 61 6c    The default al
1230: 67 6f 72 69 74 68 6d 20 69 73 20 41 42 4f 52 54  gorithm is ABORT
1240: 2e 20 20 57 68 65 6e 20 74 68 65 0a 41 42 4f 52  .  When the.ABOR
1250: 54 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 69  T algorithm is i
1260: 6e 20 75 73 65 2c 20 61 6e 79 20 63 6f 6e 73 74  n use, any const
1270: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
1280: 63 61 75 73 65 73 20 74 68 65 0a 63 6f 6d 6d 61  causes the.comma
1290: 6e 64 20 74 6f 20 61 62 6f 72 74 20 61 6e 64 20  nd to abort and 
12a0: 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e  the current tran
12b0: 73 61 63 74 69 6f 6e 20 74 6f 20 62 65 20 72 6f  saction to be ro
12c0: 6c 6c 65 64 20 62 61 63 6b 2e 0a 54 68 69 73 20  lled back..This 
12d0: 69 73 20 74 68 65 20 6f 6e 6c 79 20 62 65 68 61  is the only beha
12e0: 76 69 6f 72 20 65 78 68 69 62 69 74 65 64 20 62  vior exhibited b
12f0: 79 20 6d 6f 73 74 20 53 51 4c 20 65 6e 67 69 6e  y most SQL engin
1300: 65 73 2e 20 20 42 75 74 0a 53 51 4c 69 74 65 20  es.  But.SQLite 
1310: 61 6c 6c 6f 77 73 20 74 77 6f 20 61 6c 74 65 72  allows two alter
1320: 6e 61 74 69 76 65 20 62 65 68 61 76 69 6f 72 73  native behaviors
1330: 3a 20 49 47 4e 4f 52 45 20 61 6e 64 20 52 45 50  : IGNORE and REP
1340: 4c 41 43 45 2e 0a 54 68 65 20 49 47 4e 4f 52 45  LACE..The IGNORE
1350: 20 61 6c 67 6f 72 69 74 68 6d 20 6d 65 61 6e 73   algorithm means
1360: 20 74 68 61 74 20 77 68 65 6e 20 61 20 63 6f 6e   that when a con
1370: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
1380: 6e 20 6f 63 63 75 72 73 0a 6f 6e 20 61 20 43 4f  n occurs.on a CO
1390: 50 59 2c 20 49 4e 53 45 52 54 20 6f 72 20 55 50  PY, INSERT or UP
13a0: 44 41 54 45 2c 20 74 68 65 20 70 61 72 74 69 63  DATE, the partic
13b0: 75 6c 61 72 20 72 6f 77 20 74 68 61 74 20 63 61  ular row that ca
13c0: 75 73 65 64 20 74 68 65 20 63 6f 6e 73 74 72 61  used the constra
13d0: 69 6e 74 0a 76 69 6f 6c 61 74 69 6f 6e 20 69 73  int.violation is
13e0: 20 6e 6f 74 20 69 6e 73 65 72 74 65 64 20 6f 72   not inserted or
13f0: 20 63 68 61 6e 67 65 64 2c 20 62 75 74 20 6f 74   changed, but ot
1400: 68 65 72 20 72 6f 77 73 20 65 66 66 65 63 74 65  her rows effecte
1410: 64 20 62 79 20 74 68 65 0a 43 4f 50 59 2c 20 49  d by the.COPY, I
1420: 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45  NSERT, or UPDATE
1430: 20 61 72 65 20 69 6e 73 65 72 74 20 6f 72 20 63   are insert or c
1440: 68 61 6e 67 65 64 20 61 73 20 75 73 75 61 6c 2e  hanged as usual.
1450: 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 20 69 73 20  .The command is 
1460: 6e 6f 74 20 61 62 6f 72 74 65 64 20 61 6e 64 20  not aborted and 
1470: 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 75  no rollback occu
1480: 72 73 2e 0a 49 66 20 74 68 65 20 61 6c 67 6f 72  rs..If the algor
1490: 69 74 68 6d 20 69 73 20 52 45 50 4c 41 43 45 2c  ithm is REPLACE,
14a0: 20 74 68 65 6e 20 53 51 4c 69 74 65 20 74 72 69   then SQLite tri
14b0: 65 73 20 74 6f 0a 64 65 6c 65 74 65 20 70 72 65  es to.delete pre
14c0: 65 78 69 73 74 69 6e 67 20 72 6f 77 73 20 66 72  existing rows fr
14d0: 6f 6d 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20  om the table to 
14e0: 72 65 6d 6f 76 65 20 74 68 65 20 63 6f 6e 73 74  remove the const
14f0: 72 61 69 6e 74 0a 76 69 6f 6c 61 74 69 6f 6e 20  raint.violation 
1500: 62 65 66 6f 72 65 20 69 6e 73 65 72 74 69 6e 67  before inserting
1510: 20 6f 72 20 63 68 61 6e 67 69 6e 67 20 74 68 65   or changing the
1520: 20 72 6f 77 2e 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f   row.</p>..<p>Fo
1530: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
1540: 6f 72 6d 61 74 69 6f 6e 2c 20 73 65 65 20 0a 3c  ormation, see .<
1550: 61 20 68 72 65 66 3d 22 63 6f 6e 66 6c 69 63 74  a href="conflict
1560: 2e 68 74 6d 6c 22 3e 63 6f 6e 66 6c 69 63 74 2e  .html">conflict.
1570: 68 74 6d 6c 3c 2f 61 3e 2e 3c 2f 70 3e 0a 7d 0a  html</a>.</p>.}.
1580: 0a 53 65 63 74 69 6f 6e 20 43 4f 50 59 20 63 6f  .Section COPY co
1590: 70 79 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  py..Syntax {sql-
15a0: 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 4f 50  statement} {.COP
15b0: 59 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  Y [ <conflict-cl
15c0: 61 75 73 65 3e 20 5d 20 3c 74 61 62 6c 65 2d 6e  ause> ] <table-n
15d0: 61 6d 65 3e 20 46 52 4f 4d 20 3c 66 69 6c 65 6e  ame> FROM <filen
15e0: 61 6d 65 3e 0a 5b 20 55 53 49 4e 47 20 44 45 4c  ame>.[ USING DEL
15f0: 49 4d 49 54 45 52 53 20 3c 64 65 6c 69 6d 3e 20  IMITERS <delim> 
1600: 5d 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  ].}...puts {.<p>
1610: 54 68 65 20 43 4f 50 59 20 63 6f 6d 6d 61 6e 64  The COPY command
1620: 20 69 73 20 61 6e 20 65 78 74 65 6e 73 69 6f 6e   is an extension
1630: 20 75 73 65 64 20 74 6f 20 6c 6f 61 64 20 6c 61   used to load la
1640: 72 67 65 20 61 6d 6f 75 6e 74 73 20 6f 66 0a 64  rge amounts of.d
1650: 61 74 61 20 69 6e 74 6f 20 61 20 74 61 62 6c 65  ata into a table
1660: 2e 20 20 49 74 20 69 73 20 6d 6f 64 65 6c 65 64  .  It is modeled
1670: 20 61 66 74 65 72 20 61 20 73 69 6d 69 6c 61 72   after a similar
1680: 20 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e 64 0a 69   command found.i
1690: 6e 20 50 6f 73 74 67 72 65 53 51 4c 2e 20 20 49  n PostgreSQL.  I
16a0: 6e 20 66 61 63 74 2c 20 74 68 65 20 53 51 4c 69  n fact, the SQLi
16b0: 74 65 20 43 4f 50 59 20 63 6f 6d 6d 61 6e 64 20  te COPY command 
16c0: 69 73 20 73 70 65 63 69 66 69 63 61 6c 6c 79 0a  is specifically.
16d0: 64 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 61  designed to be a
16e0: 62 6c 65 20 74 6f 20 72 65 61 64 20 74 68 65 20  ble to read the 
16f0: 6f 75 74 70 75 74 20 6f 66 20 74 68 65 20 50 6f  output of the Po
1700: 73 74 67 72 65 53 51 4c 20 64 75 6d 70 0a 75 74  stgreSQL dump.ut
1710: 69 6c 69 74 79 20 3c 62 3e 70 67 5f 64 75 6d 70  ility <b>pg_dump
1720: 3c 2f 62 3e 20 73 6f 20 74 68 61 74 20 64 61 74  </b> so that dat
1730: 61 20 63 61 6e 20 62 65 20 65 61 73 69 6c 79 20  a can be easily 
1740: 74 72 61 6e 73 66 65 72 72 65 64 20 66 72 6f 6d  transferred from
1750: 0a 50 6f 73 74 67 72 65 53 51 4c 20 69 6e 74 6f  .PostgreSQL into
1760: 20 53 51 4c 69 74 65 2e 3c 70 3e 0a 0a 3c 70 3e   SQLite.<p>..<p>
1770: 54 68 65 20 74 61 62 6c 65 2d 6e 61 6d 65 20 69  The table-name i
1780: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 6e  s the name of an
1790: 20 65 78 69 73 74 69 6e 67 20 74 61 62 6c 65 20   existing table 
17a0: 77 68 69 63 68 20 69 73 20 74 6f 0a 62 65 20 66  which is to.be f
17b0: 69 6c 6c 65 64 20 77 69 74 68 20 64 61 74 61 2e  illed with data.
17c0: 20 20 54 68 65 20 66 69 6c 65 6e 61 6d 65 20 69    The filename i
17d0: 73 20 61 20 73 74 72 69 6e 67 20 6f 72 20 69 64  s a string or id
17e0: 65 6e 74 69 66 69 65 72 20 74 68 61 74 0a 6e 61  entifier that.na
17f0: 6d 65 73 20 61 20 66 69 6c 65 20 66 72 6f 6d 20  mes a file from 
1800: 77 68 69 63 68 20 64 61 74 61 20 77 69 6c 6c 20  which data will 
1810: 62 65 20 72 65 61 64 2e 20 20 54 68 65 20 66 69  be read.  The fi
1820: 6c 65 6e 61 6d 65 20 63 61 6e 20 62 65 0a 74 68  lename can be.th
1830: 65 20 3c 62 3e 53 54 44 49 4e 3c 2f 62 3e 20 74  e <b>STDIN</b> t
1840: 6f 20 72 65 61 64 20 64 61 74 61 20 66 72 6f 6d  o read data from
1850: 20 73 74 61 6e 64 61 72 64 20 69 6e 70 75 74 2e   standard input.
1860: 3c 70 3e 0a 0a 3c 70 3e 45 61 63 68 20 6c 69 6e  <p>..<p>Each lin
1870: 65 20 6f 66 20 74 68 65 20 69 6e 70 75 74 20 66  e of the input f
1880: 69 6c 65 20 69 73 20 63 6f 6e 76 65 72 74 65 64  ile is converted
1890: 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20 72   into a single r
18a0: 65 63 6f 72 64 0a 69 6e 20 74 68 65 20 74 61 62  ecord.in the tab
18b0: 6c 65 2e 20 20 43 6f 6c 75 6d 6e 73 20 61 72 65  le.  Columns are
18c0: 20 73 65 70 61 72 61 74 65 64 20 62 79 20 74 61   separated by ta
18d0: 62 73 2e 20 20 49 66 20 61 20 74 61 62 20 6f 63  bs.  If a tab oc
18e0: 63 75 72 73 20 61 73 0a 64 61 74 61 20 77 69 74  curs as.data wit
18f0: 68 69 6e 20 61 20 63 6f 6c 75 6d 6e 2c 20 74 68  hin a column, th
1900: 65 6e 20 74 68 61 74 20 74 61 62 20 69 73 20 70  en that tab is p
1910: 72 65 63 65 64 65 64 20 62 79 20 61 20 62 61 73  receded by a bas
1920: 6b 73 6c 61 73 68 20 22 5c 22 0a 63 68 61 72 61  kslash "\".chara
1930: 63 74 65 72 2e 20 20 41 20 62 61 73 6b 73 6c 61  cter.  A basksla
1940: 73 68 20 69 6e 20 74 68 65 20 64 61 74 61 20 61  sh in the data a
1950: 70 70 65 61 72 73 20 61 73 20 74 77 6f 20 62 61  ppears as two ba
1960: 63 6b 73 6c 61 73 68 65 73 20 69 6e 0a 61 20 72  ckslashes in.a r
1970: 6f 77 2e 20 20 54 68 65 20 6f 70 74 69 6f 6e 61  ow.  The optiona
1980: 6c 20 55 53 49 4e 47 20 44 45 4c 49 4d 49 54 45  l USING DELIMITE
1990: 52 53 20 63 6c 61 75 73 65 20 63 61 6e 20 73 70  RS clause can sp
19a0: 65 63 69 66 79 20 61 20 64 65 6c 69 6d 69 74 65  ecify a delimite
19b0: 72 0a 6f 74 68 65 72 20 74 68 61 6e 20 74 61 62  r.other than tab
19c0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 20 63  .</p>..<p>If a c
19d0: 6f 6c 75 6d 6e 20 63 6f 6e 73 69 73 74 73 20 6f  olumn consists o
19e0: 66 20 74 68 65 20 63 68 61 72 61 63 74 65 72 20  f the character 
19f0: 22 5c 4e 22 2c 20 74 68 61 74 20 63 6f 6c 75 6d  "\N", that colum
1a00: 6e 20 69 73 20 66 69 6c 6c 65 64 0a 77 69 74 68  n is filled.with
1a10: 20 74 68 65 20 76 61 6c 75 65 20 4e 55 4c 4c 2e   the value NULL.
1a20: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74  </p>..<p>The opt
1a30: 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63  ional conflict-c
1a40: 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20 74 68 65  lause allows the
1a50: 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 6f   specification o
1a60: 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65  f an alternative
1a70: 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66  .constraint conf
1a80: 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20  lict resolution 
1a90: 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 75 73 65  algorithm to use
1aa0: 20 66 6f 72 20 74 68 69 73 20 6f 6e 65 20 63 6f   for this one co
1ab0: 6d 6d 61 6e 64 2e 0a 53 65 65 20 74 68 65 20 73  mmand..See the s
1ac0: 65 63 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61  ection titled.<a
1ad0: 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74   href="#conflict
1ae0: 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61  ">ON CONFLICT</a
1af0: 3e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  > for additional
1b00: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70   information.</p
1b10: 3e 0a 0a 3c 70 3e 57 68 65 6e 20 74 68 65 20 69  >..<p>When the i
1b20: 6e 70 75 74 20 64 61 74 61 20 73 6f 75 72 63 65  nput data source
1b30: 20 69 73 20 53 54 44 49 4e 2c 20 74 68 65 20 69   is STDIN, the i
1b40: 6e 70 75 74 20 63 61 6e 20 62 65 20 74 65 72 6d  nput can be term
1b50: 69 6e 61 74 65 64 0a 62 79 20 61 20 6c 69 6e 65  inated.by a line
1b60: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 6f   that contains o
1b70: 6e 6c 79 20 61 20 62 61 73 6b 73 6c 61 73 68 20  nly a baskslash 
1b80: 61 6e 64 20 61 20 64 6f 74 3a 7d 0a 70 75 74 73  and a dot:}.puts
1b90: 20 22 5c 22 5b 4f 70 65 72 61 74 6f 72 20 5c 5c   "\"[Operator \\
1ba0: 2e 5d 5c 22 2e 3c 2f 70 3e 22 0a 0a 53 65 63 74  .]\".</p>"..Sect
1bb0: 69 6f 6e 20 7b 43 52 45 41 54 45 20 49 4e 44 45  ion {CREATE INDE
1bc0: 58 7d 20 63 72 65 61 74 65 69 6e 64 65 78 0a 0a  X} createindex..
1bd0: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
1be0: 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41 54 45 20  ement} {.CREATE 
1bf0: 5b 55 4e 49 51 55 45 5d 20 49 4e 44 45 58 20 3c  [UNIQUE] INDEX <
1c00: 69 6e 64 65 78 2d 6e 61 6d 65 3e 20 0a 4f 4e 20  index-name> .ON 
1c10: 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28 20 3c  <table-name> ( <
1c20: 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 5b 2c 20  column-name> [, 
1c30: 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 5d 2a 20  <column-name>]* 
1c40: 29 0a 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  ).[ <conflict-cl
1c50: 61 75 73 65 3e 20 5d 0a 7d 20 7b 63 6f 6c 75 6d  ause> ].} {colum
1c60: 6e 2d 6e 61 6d 65 7d 20 7b 0a 3c 6e 61 6d 65 3e  n-name} {.<name>
1c70: 20 5b 20 41 53 43 20 7c 20 44 45 53 43 20 5d 0a   [ ASC | DESC ].
1c80: 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  }...puts {.<p>Th
1c90: 65 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 63  e CREATE INDEX c
1ca0: 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20  ommand consists 
1cb0: 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20  of the keywords 
1cc0: 22 43 52 45 41 54 45 20 49 4e 44 45 58 22 20 66  "CREATE INDEX" f
1cd0: 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e  ollowed.by the n
1ce0: 61 6d 65 20 6f 66 20 74 68 65 20 6e 65 77 20 69  ame of the new i
1cf0: 6e 64 65 78 2c 20 74 68 65 20 6b 65 79 77 6f 72  ndex, the keywor
1d00: 64 20 22 4f 4e 22 2c 20 74 68 65 20 6e 61 6d 65  d "ON", the name
1d10: 20 6f 66 20 61 20 70 72 65 76 69 6f 75 73 6c 79   of a previously
1d20: 0a 63 72 65 61 74 65 64 20 74 61 62 6c 65 20 74  .created table t
1d30: 68 61 74 20 69 73 20 74 6f 20 62 65 20 69 6e 64  hat is to be ind
1d40: 65 78 65 64 2c 20 61 6e 64 20 61 20 70 61 72 65  exed, and a pare
1d50: 6e 74 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f  nthesized list o
1d60: 66 20 6e 61 6d 65 73 20 6f 66 0a 63 6f 6c 75 6d  f names of.colum
1d70: 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20  ns in the table 
1d80: 74 68 61 74 20 61 72 65 20 75 73 65 64 20 66 6f  that are used fo
1d90: 72 20 74 68 65 20 69 6e 64 65 78 20 6b 65 79 2e  r the index key.
1da0: 0a 45 61 63 68 20 63 6f 6c 75 6d 6e 20 6e 61 6d  .Each column nam
1db0: 65 20 63 61 6e 20 62 65 20 66 6f 6c 6c 6f 77 65  e can be followe
1dc0: 64 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20  d by one of the 
1dd0: 22 41 53 43 22 20 6f 72 20 22 44 45 53 43 22 20  "ASC" or "DESC" 
1de0: 6b 65 79 77 6f 72 64 73 0a 74 6f 20 69 6e 64 69  keywords.to indi
1df0: 63 61 74 65 20 73 6f 72 74 20 6f 72 64 65 72 2c  cate sort order,
1e00: 20 62 75 74 20 74 68 65 20 73 6f 72 74 20 6f 72   but the sort or
1e10: 64 65 72 20 69 73 20 69 67 6e 6f 72 65 64 20 69  der is ignored i
1e20: 6e 20 74 68 65 20 63 75 72 72 65 6e 74 0a 69 6d  n the current.im
1e30: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 3c 2f 70  plementation.</p
1e40: 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65 20  >..<p>There are 
1e50: 6e 6f 20 61 72 62 69 74 72 61 72 79 20 6c 69 6d  no arbitrary lim
1e60: 69 74 73 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65  its on the numbe
1e70: 72 20 6f 66 20 69 6e 64 69 63 65 73 20 74 68 61  r of indices tha
1e80: 74 20 63 61 6e 20 62 65 0a 61 74 74 61 63 68 65  t can be.attache
1e90: 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 74 61  d to a single ta
1ea0: 62 6c 65 2c 20 6e 6f 72 20 6f 6e 20 74 68 65 20  ble, nor on the 
1eb0: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
1ec0: 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 2e 3c 2f  s in an index.</
1ed0: 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20 55 4e  p>..<p>If the UN
1ee0: 49 51 55 45 20 6b 65 79 77 6f 72 64 20 61 70 70  IQUE keyword app
1ef0: 65 61 72 73 20 62 65 74 77 65 65 6e 20 43 52 45  ears between CRE
1f00: 41 54 45 20 61 6e 64 20 49 4e 44 45 58 20 74 68  ATE and INDEX th
1f10: 65 6e 20 64 75 70 6c 69 63 61 74 65 0a 69 6e 64  en duplicate.ind
1f20: 65 78 20 65 6e 74 72 69 65 73 20 61 72 65 20 6e  ex entries are n
1f30: 6f 74 20 61 6c 6c 6f 77 65 64 2e 20 20 41 6e 79  ot allowed.  Any
1f40: 20 61 74 74 65 6d 70 74 20 74 6f 20 69 6e 73 65   attempt to inse
1f50: 72 74 20 61 20 64 75 70 6c 69 63 61 74 65 20 65  rt a duplicate e
1f60: 6e 74 72 79 0a 77 69 6c 6c 20 72 65 73 75 6c 74  ntry.will result
1f70: 20 69 6e 20 61 20 72 6f 6c 6c 62 61 63 6b 20 61   in a rollback a
1f80: 6e 64 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  nd an error mess
1f90: 61 67 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  age.</p>..<p>The
1fa0: 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69   optional confli
1fb0: 63 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73  ct-clause allows
1fc0: 20 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69   the specificati
1fd0: 6f 6e 20 6f 66 20 61 6c 20 61 6c 74 65 72 6e 61  on of al alterna
1fe0: 74 69 76 65 0a 64 65 66 61 75 6c 74 20 63 6f 6e  tive.default con
1ff0: 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c 69 63 74  straint conflict
2000: 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f   resolution algo
2010: 72 69 74 68 6d 20 66 6f 72 20 74 68 69 73 20 69  rithm for this i
2020: 6e 64 65 78 2e 0a 54 68 69 73 20 6f 6e 6c 79 20  ndex..This only 
2030: 6d 61 6b 65 73 20 73 65 6e 73 65 20 69 66 20 74  makes sense if t
2040: 68 65 20 55 4e 49 51 55 45 20 6b 65 79 77 6f 72  he UNIQUE keywor
2050: 64 20 69 73 20 75 73 65 64 20 73 69 6e 63 65 20  d is used since 
2060: 6f 74 68 65 72 77 69 73 65 0a 74 68 65 72 65 20  otherwise.there 
2070: 61 72 65 20 6e 6f 74 20 63 6f 6e 73 74 72 61 69  are not constrai
2080: 6e 74 73 20 6f 6e 20 74 68 65 20 69 6e 64 65 78  nts on the index
2090: 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 61  .  The default a
20a0: 6c 67 6f 72 69 74 68 6d 20 69 73 0a 41 42 4f 52  lgorithm is.ABOR
20b0: 54 2e 20 20 49 66 20 61 20 43 4f 50 59 2c 20 49  T.  If a COPY, I
20c0: 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45  NSERT, or UPDATE
20d0: 20 73 74 61 74 65 6d 65 6e 74 20 73 70 65 63 69   statement speci
20e0: 66 69 65 73 20 61 20 70 61 72 74 69 63 75 6c 61  fies a particula
20f0: 72 0a 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c  r.conflict resol
2100: 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2c  ution algorithm,
2110: 20 74 68 61 74 20 61 6c 67 6f 72 69 74 68 6d 20   that algorithm 
2120: 69 73 20 75 73 65 64 20 69 6e 20 70 6c 61 63 65  is used in place
2130: 20 6f 66 0a 74 68 65 20 64 65 66 61 75 6c 74 20   of.the default 
2140: 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63 69 66  algorithm specif
2150: 69 65 64 20 68 65 72 65 2e 0a 53 65 65 20 74 68  ied here..See th
2160: 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c 65 64  e section titled
2170: 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c  .<a href="#confl
2180: 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54  ict">ON CONFLICT
2190: 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74 69 6f  </a> for additio
21a0: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e  nal information.
21b0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 65 78 61  </p>..<p>The exa
21c0: 63 74 20 74 65 78 74 0a 6f 66 20 65 61 63 68 20  ct text.of each 
21d0: 43 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61  CREATE INDEX sta
21e0: 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 65 64  tement is stored
21f0: 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c 69 74   in the <b>sqlit
2200: 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a 74 61 62  e_master</b>.tab
2210: 6c 65 2e 20 20 45 76 65 72 79 74 69 6d 65 20 74  le.  Everytime t
2220: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6f  he database is o
2230: 70 65 6e 65 64 2c 20 61 6c 6c 20 43 52 45 41 54  pened, all CREAT
2240: 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e  E INDEX statemen
2250: 74 73 0a 61 72 65 20 72 65 61 64 20 66 72 6f 6d  ts.are read from
2260: 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d   the <b>sqlite_m
2270: 61 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65 20  aster</b> table 
2280: 61 6e 64 20 75 73 65 64 20 74 6f 20 72 65 67 65  and used to rege
2290: 6e 65 72 61 74 65 0a 53 51 4c 69 74 65 27 73 20  nerate.SQLite's 
22a0: 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73 65  internal represe
22b0: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 69  ntation of the i
22c0: 6e 64 65 78 20 6c 61 79 6f 75 74 2e 3c 2f 70 3e  ndex layout.</p>
22d0: 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 43 52  .}...Section {CR
22e0: 45 41 54 45 20 54 41 42 4c 45 7d 20 7b 63 72 65  EATE TABLE} {cre
22f0: 61 74 65 74 61 62 6c 65 7d 0a 0a 53 79 6e 74 61  atetable}..Synta
2300: 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20  x {sql-command} 
2310: 7b 0a 43 52 45 41 54 45 20 5b 54 45 4d 50 20 7c  {.CREATE [TEMP |
2320: 20 54 45 4d 50 4f 52 41 52 59 5d 20 54 41 42 4c   TEMPORARY] TABL
2330: 45 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28  E <table-name> (
2340: 0a 20 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e 20  .  <column-def> 
2350: 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e 5d  [, <column-def>]
2360: 2a 0a 20 20 5b 2c 20 3c 63 6f 6e 73 74 72 61 69  *.  [, <constrai
2370: 6e 74 3e 5d 2a 0a 29 0a 7d 20 7b 63 6f 6c 75 6d  nt>]*.).} {colum
2380: 6e 2d 64 65 66 7d 20 7b 0a 3c 6e 61 6d 65 3e 20  n-def} {.<name> 
2390: 3c 74 79 70 65 3e 20 5b 3c 63 6f 6c 75 6d 6e 2d  <type> [<column-
23a0: 63 6f 6e 73 74 72 61 69 6e 74 3e 5d 2a 0a 7d 20  constraint>]*.} 
23b0: 7b 74 79 70 65 7d 20 7b 0a 3c 74 79 70 65 6e 61  {type} {.<typena
23c0: 6d 65 3e 20 7c 0a 3c 74 79 70 65 6e 61 6d 65 3e  me> |.<typename>
23d0: 20 28 20 3c 6e 75 6d 62 65 72 3e 20 29 20 7c 0a   ( <number> ) |.
23e0: 3c 74 79 70 65 6e 61 6d 65 3e 20 28 20 3c 6e 75  <typename> ( <nu
23f0: 6d 62 65 72 3e 20 2c 20 3c 6e 75 6d 62 65 72 3e  mber> , <number>
2400: 20 29 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 63 6f 6e   ).} {column-con
2410: 73 74 72 61 69 6e 74 7d 20 7b 0a 4e 4f 54 20 4e  straint} {.NOT N
2420: 55 4c 4c 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d  ULL [ <conflict-
2430: 63 6c 61 75 73 65 3e 20 5d 20 7c 0a 50 52 49 4d  clause> ] |.PRIM
2440: 41 52 59 20 4b 45 59 20 5b 3c 73 6f 72 74 2d 6f  ARY KEY [<sort-o
2450: 72 64 65 72 3e 5d 20 5b 20 3c 63 6f 6e 66 6c 69  rder>] [ <confli
2460: 63 74 2d 63 6c 61 75 73 65 3e 20 5d 20 7c 0a 55  ct-clause> ] |.U
2470: 4e 49 51 55 45 20 5b 20 3c 63 6f 6e 66 6c 69 63  NIQUE [ <conflic
2480: 74 2d 63 6c 61 75 73 65 3e 20 5d 20 7c 0a 43 48  t-clause> ] |.CH
2490: 45 43 4b 20 28 20 3c 65 78 70 72 3e 20 29 20 5b  ECK ( <expr> ) [
24a0: 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73   <conflict-claus
24b0: 65 3e 20 5d 20 7c 0a 44 45 46 41 55 4c 54 20 3c  e> ] |.DEFAULT <
24c0: 76 61 6c 75 65 3e 0a 7d 20 7b 63 6f 6e 73 74 72  value>.} {constr
24d0: 61 69 6e 74 7d 20 7b 0a 50 52 49 4d 41 52 59 20  aint} {.PRIMARY 
24e0: 4b 45 59 20 28 20 3c 6e 61 6d 65 3e 20 5b 2c 20  KEY ( <name> [, 
24f0: 3c 6e 61 6d 65 3e 5d 2a 20 29 20 5b 20 3c 63 6f  <name>]* ) [ <co
2500: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d  nflict-clause> ]
2510: 7c 0a 55 4e 49 51 55 45 20 28 20 3c 6e 61 6d 65  |.UNIQUE ( <name
2520: 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d 2a 20 29 20  > [, <name>]* ) 
2530: 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  [ <conflict-clau
2540: 73 65 3e 20 5d 20 7c 0a 43 48 45 43 4b 20 28 20  se> ] |.CHECK ( 
2550: 3c 65 78 70 72 3e 20 29 20 5b 20 3c 63 6f 6e 66  <expr> ) [ <conf
2560: 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d 0a 7d  lict-clause> ].}
2570: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 41 20 43 52  ..puts {.<p>A CR
2580: 45 41 54 45 20 54 41 42 4c 45 20 73 74 61 74 65  EATE TABLE state
2590: 6d 65 6e 74 20 69 73 20 62 61 73 69 63 61 6c 6c  ment is basicall
25a0: 79 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22  y the keywords "
25b0: 43 52 45 41 54 45 20 54 41 42 4c 45 22 0a 66 6f  CREATE TABLE".fo
25c0: 6c 6c 6f 77 65 64 20 62 79 20 74 68 65 20 6e 61  llowed by the na
25d0: 6d 65 20 6f 66 20 61 20 6e 65 77 20 74 61 62 6c  me of a new tabl
25e0: 65 20 61 6e 64 20 61 20 70 61 72 65 6e 74 68 65  e and a parenthe
25f0: 73 69 7a 65 64 20 6c 69 73 74 20 6f 66 20 63 6f  sized list of co
2600: 6c 75 6d 6e 0a 64 65 66 69 6e 69 74 69 6f 6e 73  lumn.definitions
2610: 20 61 6e 64 20 63 6f 6e 73 74 72 61 69 6e 74 73   and constraints
2620: 2e 20 20 54 68 65 20 74 61 62 6c 65 20 6e 61 6d  .  The table nam
2630: 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20  e can be either 
2640: 61 6e 20 69 64 65 6e 74 69 66 69 65 72 0a 6f 72  an identifier.or
2650: 20 61 20 73 74 72 69 6e 67 2e 20 20 54 68 65 20   a string.  The 
2660: 6f 6e 6c 79 20 72 65 73 65 72 76 65 64 20 74 61  only reserved ta
2670: 62 6c 65 20 6e 61 6d 65 20 69 73 20 22 3c 62 3e  ble name is "<b>
2680: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62  sqlite_master</b
2690: 3e 22 20 77 68 69 63 68 0a 69 73 20 74 68 65 20  >" which.is the 
26a0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
26b0: 65 20 74 68 61 74 20 72 65 63 6f 72 64 73 20 74  e that records t
26c0: 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65  he database sche
26d0: 6d 61 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45 61 63 68  ma.</p>..<p>Each
26e0: 20 63 6f 6c 75 6d 6e 20 64 65 66 69 6e 69 74 69   column definiti
26f0: 6f 6e 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f  on is the name o
2700: 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 66 6f 6c  f the column fol
2710: 6c 6f 77 65 64 20 62 79 20 74 68 65 0a 64 61 74  lowed by the.dat
2720: 61 74 79 70 65 20 66 6f 72 20 74 68 61 74 20 63  atype for that c
2730: 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20 6f 6e 65 20  olumn, then one 
2740: 6f 72 20 6d 6f 72 65 20 6f 70 74 69 6f 6e 61 6c  or more optional
2750: 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73 74 72 61 69   column constrai
2760: 6e 74 73 2e 0a 54 68 65 20 64 61 74 61 74 79 70  nts..The datatyp
2770: 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e  e for the column
2780: 20 69 73 20 69 67 6e 6f 72 65 64 2e 20 20 41 6c   is ignored.  Al
2790: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 69 73  l information.is
27a0: 20 73 74 6f 72 65 64 20 61 73 20 6e 75 6c 6c 2d   stored as null-
27b0: 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e  terminated strin
27c0: 67 73 2e 0a 54 68 65 20 55 4e 49 51 55 45 20 63  gs..The UNIQUE c
27d0: 6f 6e 73 74 72 61 69 6e 74 20 63 61 75 73 65 73  onstraint causes
27e0: 20 61 6e 20 69 6e 64 65 78 20 74 6f 20 62 65 20   an index to be 
27f0: 63 72 65 61 74 65 64 20 6f 6e 20 74 68 65 20 73  created on the s
2800: 70 65 63 69 66 69 65 64 0a 63 6f 6c 75 6d 6e 73  pecified.columns
2810: 2e 20 20 54 68 69 73 20 69 6e 64 65 78 20 6d 75  .  This index mu
2820: 73 74 20 63 6f 6e 74 61 69 6e 20 75 6e 69 71 75  st contain uniqu
2830: 65 20 6b 65 79 73 2e 0a 54 68 65 20 44 45 46 41  e keys..The DEFA
2840: 55 4c 54 20 63 6f 6e 73 74 72 61 69 6e 74 0a 73  ULT constraint.s
2850: 70 65 63 69 66 69 65 73 20 61 20 64 65 66 61 75  pecifies a defau
2860: 6c 74 20 76 61 6c 75 65 20 74 6f 20 75 73 65 20  lt value to use 
2870: 77 68 65 6e 20 64 6f 69 6e 67 20 61 6e 20 49 4e  when doing an IN
2880: 53 45 52 54 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 53  SERT..</p>..<p>S
2890: 70 65 63 69 66 79 69 6e 67 20 61 20 50 52 49 4d  pecifying a PRIM
28a0: 41 52 59 20 4b 45 59 20 6e 6f 72 6d 61 6c 6c 79  ARY KEY normally
28b0: 20 6a 75 73 74 20 63 72 65 61 74 65 73 20 61 20   just creates a 
28c0: 55 4e 49 51 55 45 20 69 6e 64 65 78 0a 6f 6e 20  UNIQUE index.on 
28d0: 74 68 65 20 70 72 69 6d 61 72 79 20 6b 65 79 2e  the primary key.
28e0: 20 20 48 6f 77 65 76 65 72 2c 20 69 66 20 70 72    However, if pr
28f0: 69 6d 61 72 79 20 6b 65 79 20 69 73 20 6f 6e 20  imary key is on 
2900: 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 0a  a single column.
2910: 74 68 61 74 20 68 61 73 20 64 61 74 61 74 79 70  that has datatyp
2920: 65 20 49 4e 54 45 47 45 52 2c 20 74 68 65 6e 20  e INTEGER, then 
2930: 74 68 61 74 20 63 6f 6c 75 6d 6e 20 69 73 20 75  that column is u
2940: 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 61  sed internally.a
2950: 73 20 74 68 65 20 61 63 74 75 61 6c 20 6b 65 79  s the actual key
2960: 20 6f 66 20 74 68 65 20 42 2d 54 72 65 65 20 66   of the B-Tree f
2970: 6f 72 20 74 68 65 20 74 61 62 6c 65 2e 20 20 54  or the table.  T
2980: 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 74  his means that t
2990: 68 65 20 63 6f 6c 75 6d 6e 0a 6d 61 79 20 6f 6e  he column.may on
29a0: 6c 79 20 68 6f 6c 64 20 75 6e 69 71 75 65 20 69  ly hold unique i
29b0: 6e 74 65 67 65 72 20 76 61 6c 75 65 73 2e 20 20  nteger values.  
29c0: 28 45 78 63 65 70 74 20 66 6f 72 20 74 68 69 73  (Except for this
29d0: 20 6f 6e 65 20 63 61 73 65 2c 0a 53 51 4c 69 74   one case,.SQLit
29e0: 65 20 69 67 6e 6f 72 65 73 20 74 68 65 20 64 61  e ignores the da
29f0: 74 61 74 79 70 65 20 73 70 65 63 69 66 69 63 61  tatype specifica
2a00: 74 69 6f 6e 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  tion of columns 
2a10: 61 6e 64 20 61 6c 6c 6f 77 73 0a 61 6e 79 20 6b  and allows.any k
2a20: 69 6e 64 20 6f 66 20 64 61 74 61 20 74 6f 20 62  ind of data to b
2a30: 65 20 70 75 74 20 69 6e 20 61 20 63 6f 6c 75 6d  e put in a colum
2a40: 6e 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20  n regardless of 
2a50: 69 74 73 20 64 65 63 6c 61 72 65 64 0a 64 61 74  its declared.dat
2a60: 61 74 79 70 65 2e 29 20 20 49 66 20 61 20 74 61  atype.)  If a ta
2a70: 62 6c 65 20 64 6f 65 73 20 6e 6f 74 20 68 61 76  ble does not hav
2a80: 65 20 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49  e an INTEGER PRI
2a90: 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 2c  MARY KEY column,
2aa0: 0a 74 68 65 6e 20 74 68 65 20 42 2d 54 72 65 65  .then the B-Tree
2ab0: 20 6b 65 79 20 77 69 6c 6c 20 62 65 20 61 20 72   key will be a r
2ac0: 61 6e 64 6f 6d 6c 79 20 67 65 6e 65 72 61 74 65  andomly generate
2ad0: 64 20 69 6e 74 65 67 65 72 2e 20 20 54 68 65 0a  d integer.  The.
2ae0: 42 2d 54 72 65 65 20 6b 65 79 20 66 6f 72 20 61  B-Tree key for a
2af0: 20 72 6f 77 20 63 61 6e 20 61 6c 77 61 79 73 20   row can always 
2b00: 62 65 20 61 63 63 65 73 73 65 64 20 75 73 69 6e  be accessed usin
2b10: 67 20 6f 6e 65 20 6f 66 20 74 68 65 0a 73 70 65  g one of the.spe
2b20: 63 69 61 6c 20 6e 61 6d 65 73 20 22 3c 62 3e 52  cial names "<b>R
2b30: 4f 57 49 44 3c 2f 62 3e 22 2c 20 22 3c 62 3e 4f  OWID</b>", "<b>O
2b40: 49 44 3c 2f 62 3e 22 2c 20 6f 72 20 22 3c 62 3e  ID</b>", or "<b>
2b50: 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54 68  _ROWID_</b>"..Th
2b60: 69 73 20 69 73 20 74 72 75 65 20 72 65 67 61 72  is is true regar
2b70: 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72  dless of whether
2b80: 20 6f 72 20 6e 6f 74 20 74 68 65 72 65 20 69 73   or not there is
2b90: 20 61 6e 20 49 4e 54 45 47 45 52 0a 50 52 49 4d   an INTEGER.PRIM
2ba0: 41 52 59 20 4b 45 59 2e 3c 2f 70 3e 0a 0a 3c 70  ARY KEY.</p>..<p
2bb0: 3e 49 66 20 74 68 65 20 22 54 45 4d 50 22 20 6f  >If the "TEMP" o
2bc0: 72 20 22 54 45 4d 50 4f 52 41 52 59 22 20 6b 65  r "TEMPORARY" ke
2bd0: 79 77 6f 72 64 20 6f 63 63 75 72 73 20 69 6e 20  yword occurs in 
2be0: 62 65 74 77 65 65 6e 20 22 43 52 45 41 54 45 22  between "CREATE"
2bf0: 0a 61 6e 64 20 22 54 41 42 4c 45 22 20 74 68 65  .and "TABLE" the
2c00: 6e 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74  n the table that
2c10: 20 69 73 20 63 72 65 61 74 65 64 20 69 73 20 6f   is created is o
2c20: 6e 6c 79 20 76 69 73 69 62 6c 65 20 74 6f 20 74  nly visible to t
2c30: 68 65 0a 70 72 6f 63 65 73 73 20 74 68 61 74 20  he.process that 
2c40: 6f 70 65 6e 65 64 20 74 68 65 20 64 61 74 61 62  opened the datab
2c50: 61 73 65 20 61 6e 64 20 69 73 20 61 75 74 6f 6d  ase and is autom
2c60: 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64  atically deleted
2c70: 20 77 68 65 6e 0a 74 68 65 20 64 61 74 61 62 61   when.the databa
2c80: 73 65 20 69 73 20 63 6c 6f 73 65 64 2e 20 20 41  se is closed.  A
2c90: 6e 79 20 69 6e 64 69 63 65 73 20 63 72 65 61 74  ny indices creat
2ca0: 65 64 20 6f 6e 20 61 20 74 65 6d 70 6f 72 61 72  ed on a temporar
2cb0: 79 20 74 61 62 6c 65 0a 61 72 65 20 61 6c 73 6f  y table.are also
2cc0: 20 74 65 6d 70 6f 72 61 72 79 2e 20 20 54 65 6d   temporary.  Tem
2cd0: 70 6f 72 61 72 79 20 74 61 62 6c 65 73 20 61 6e  porary tables an
2ce0: 64 20 69 6e 64 69 63 65 73 20 61 72 65 20 73 74  d indices are st
2cf0: 6f 72 65 64 20 69 6e 20 61 0a 73 65 70 61 72 61  ored in a.separa
2d00: 74 65 20 66 69 6c 65 20 64 69 73 74 69 6e 63 74  te file distinct
2d10: 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20 64   from the main d
2d20: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 3c 2f 70  atabase file.</p
2d30: 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e  >..<p>The option
2d40: 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  al conflict-clau
2d50: 73 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 61 63  se following eac
2d60: 68 20 63 6f 6e 73 74 72 61 69 6e 74 0a 61 6c 6c  h constraint.all
2d70: 6f 77 73 20 74 68 65 20 73 70 65 63 69 66 69 63  ows the specific
2d80: 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61 6c 74 65  ation of an alte
2d90: 72 6e 61 74 69 76 65 20 64 65 66 61 75 6c 74 0a  rnative default.
2da0: 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c  constraint confl
2db0: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
2dc0: 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 74 68 61  lgorithm for tha
2dd0: 74 20 63 6f 6e 73 74 72 61 69 6e 74 2e 0a 54 68  t constraint..Th
2de0: 65 20 64 65 66 61 75 6c 74 20 69 73 20 61 62 6f  e default is abo
2df0: 72 74 20 41 42 4f 52 54 2e 20 20 44 69 66 66 65  rt ABORT.  Diffe
2e00: 72 65 6e 74 20 63 6f 6e 73 74 72 61 69 6e 74 73  rent constraints
2e10: 20 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65   within the same
2e20: 0a 74 61 62 6c 65 20 6d 61 79 20 68 61 76 65 20  .table may have 
2e30: 64 69 66 66 65 72 65 6e 74 20 64 65 66 61 75 6c  different defaul
2e40: 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c  t conflict resol
2e50: 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 73  ution algorithms
2e60: 2e 0a 49 66 20 61 6e 20 43 4f 50 59 2c 20 49 4e  ..If an COPY, IN
2e70: 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45 20  SERT, or UPDATE 
2e80: 63 6f 6d 6d 61 6e 64 20 73 70 65 63 69 66 69 65  command specifie
2e90: 73 20 61 20 64 69 66 66 65 72 65 6e 74 20 63 6f  s a different co
2ea0: 6e 66 6c 69 63 74 0a 72 65 73 6f 6c 75 74 69 6f  nflict.resolutio
2eb0: 6e 20 61 6c 67 6f 72 69 74 68 6d 2c 20 74 68 65  n algorithm, the
2ec0: 6e 20 74 68 61 74 20 61 6c 67 6f 72 69 74 68 6d  n that algorithm
2ed0: 20 69 73 20 75 73 65 64 20 69 6e 20 70 6c 61 63   is used in plac
2ee0: 65 20 6f 66 20 74 68 65 0a 64 65 66 61 75 6c 74  e of the.default
2ef0: 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63 69   algorithm speci
2f00: 66 69 65 64 20 69 6e 20 74 68 65 20 43 52 45 41  fied in the CREA
2f10: 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65  TE TABLE stateme
2f20: 6e 74 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74  nt..See the sect
2f30: 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72  ion titled.<a hr
2f40: 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f  ef="#conflict">O
2f50: 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66  N CONFLICT</a> f
2f60: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  or additional in
2f70: 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  formation.</p>..
2f80: 3c 70 3e 43 48 45 43 4b 20 63 6f 6e 73 74 72 61  <p>CHECK constra
2f90: 69 6e 74 73 20 61 72 65 20 69 67 6e 6f 72 65 64  ints are ignored
2fa0: 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20   in the current 
2fb0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a  implementation..
2fc0: 53 75 70 70 6f 72 74 20 66 6f 72 20 43 48 45 43  Support for CHEC
2fd0: 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6d 61  K constraints ma
2fe0: 79 20 62 65 20 61 64 64 65 64 20 69 6e 20 74 68  y be added in th
2ff0: 65 20 66 75 74 75 72 65 2e 20 20 41 73 20 6f 66  e future.  As of
3000: 0a 76 65 72 73 69 6f 6e 20 32 2e 33 2e 30 2c 20  .version 2.3.0, 
3010: 4e 4f 54 20 4e 55 4c 4c 2c 20 50 52 49 4d 41 52  NOT NULL, PRIMAR
3020: 59 20 4b 45 59 2c 20 61 6e 64 20 55 4e 49 51 55  Y KEY, and UNIQU
3030: 45 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 6c  E constraints al
3040: 6c 0a 77 6f 72 6b 2e 3c 2f 70 3e 0a 0a 3c 70 3e  l.work.</p>..<p>
3050: 54 68 65 72 65 20 61 72 65 20 6e 6f 20 61 72 62  There are no arb
3060: 69 74 72 61 72 79 20 6c 69 6d 69 74 73 20 6f 6e  itrary limits on
3070: 20 74 68 65 20 6e 75 6d 62 65 72 0a 6f 66 20 63   the number.of c
3080: 6f 6c 75 6d 6e 73 20 6f 72 20 6f 6e 20 74 68 65  olumns or on the
3090: 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6e 73 74   number of const
30a0: 72 61 69 6e 74 73 20 69 6e 20 61 20 74 61 62 6c  raints in a tabl
30b0: 65 2e 0a 54 68 65 20 74 6f 74 61 6c 20 61 6d 6f  e..The total amo
30c0: 75 6e 74 20 6f 66 20 64 61 74 61 20 69 6e 20 61  unt of data in a
30d0: 20 73 69 6e 67 6c 65 20 72 6f 77 20 69 73 20 6c   single row is l
30e0: 69 6d 69 74 65 64 20 74 6f 20 61 62 6f 75 74 0a  imited to about.
30f0: 31 20 6d 65 67 61 62 79 74 65 73 2e 20 20 28 54  1 megabytes.  (T
3100: 68 69 73 20 6c 69 6d 69 74 20 63 61 6e 20 62 65  his limit can be
3110: 20 69 6e 63 72 65 61 73 65 64 20 74 6f 20 31 36   increased to 16
3120: 4d 42 20 62 79 20 63 68 61 6e 67 69 6e 67 0a 61  MB by changing.a
3130: 20 73 69 6e 67 6c 65 20 23 64 65 66 69 6e 65 20   single #define 
3140: 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f  in the source co
3150: 64 65 20 61 6e 64 20 72 65 63 6f 6d 70 69 6c 69  de and recompili
3160: 6e 67 2e 29 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ng.)</p>..<p>The
3170: 20 65 78 61 63 74 20 74 65 78 74 0a 6f 66 20 65   exact text.of e
3180: 61 63 68 20 43 52 45 41 54 45 20 54 41 42 4c 45  ach CREATE TABLE
3190: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73 74   statement is st
31a0: 6f 72 65 64 20 69 6e 20 74 68 65 20 3c 62 3e 73  ored in the <b>s
31b0: 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e  qlite_master</b>
31c0: 0a 74 61 62 6c 65 2e 20 20 45 76 65 72 79 74 69  .table.  Everyti
31d0: 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  me the database 
31e0: 69 73 20 6f 70 65 6e 65 64 2c 20 61 6c 6c 20 43  is opened, all C
31f0: 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61 74  REATE TABLE stat
3200: 65 6d 65 6e 74 73 0a 61 72 65 20 72 65 61 64 20  ements.are read 
3210: 66 72 6f 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69  from the <b>sqli
3220: 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61  te_master</b> ta
3230: 62 6c 65 20 61 6e 64 20 75 73 65 64 20 74 6f 20  ble and used to 
3240: 72 65 67 65 6e 65 72 61 74 65 0a 53 51 4c 69 74  regenerate.SQLit
3250: 65 27 73 20 69 6e 74 65 72 6e 61 6c 20 72 65 70  e's internal rep
3260: 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  resentation of t
3270: 68 65 20 74 61 62 6c 65 20 6c 61 79 6f 75 74 2e  he table layout.
3280: 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20  </p>.}..Section 
3290: 44 45 4c 45 54 45 20 64 65 6c 65 74 65 0a 0a 53  DELETE delete..S
32a0: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
32b0: 6d 65 6e 74 7d 20 7b 0a 44 45 4c 45 54 45 20 46  ment} {.DELETE F
32c0: 52 4f 4d 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  ROM <table-name>
32d0: 20 5b 57 48 45 52 45 20 3c 65 78 70 72 65 73 73   [WHERE <express
32e0: 69 6f 6e 3e 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a  ion>].}..puts {.
32f0: 3c 70 3e 54 68 65 20 44 45 4c 45 54 45 20 63 6f  <p>The DELETE co
3300: 6d 6d 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f  mmand is used to
3310: 20 72 65 6d 6f 76 65 20 72 65 63 6f 72 64 73 20   remove records 
3320: 66 72 6f 6d 20 61 20 74 61 62 6c 65 2e 0a 54 68  from a table..Th
3330: 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73  e command consis
3340: 74 73 20 6f 66 20 74 68 65 20 22 44 45 4c 45 54  ts of the "DELET
3350: 45 20 46 52 4f 4d 22 20 6b 65 79 77 6f 72 64 73  E FROM" keywords
3360: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 0a 74 68 65   followed by.the
3370: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
3380: 6c 65 20 66 72 6f 6d 20 77 68 69 63 68 20 72 65  le from which re
3390: 63 6f 72 64 73 20 61 72 65 20 74 6f 20 62 65 20  cords are to be 
33a0: 72 65 6d 6f 76 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c  removed..</p>..<
33b0: 70 3e 57 69 74 68 6f 75 74 20 61 20 57 48 45 52  p>Without a WHER
33c0: 45 20 63 6c 61 75 73 65 2c 20 61 6c 6c 20 72 6f  E clause, all ro
33d0: 77 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  ws of the table 
33e0: 61 72 65 20 72 65 6d 6f 76 65 64 2e 0a 49 66 20  are removed..If 
33f0: 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 69  a WHERE clause i
3400: 73 20 73 75 70 70 6c 69 65 64 2c 20 74 68 65 6e  s supplied, then
3410: 20 6f 6e 6c 79 20 74 68 6f 73 65 20 72 6f 77 73   only those rows
3420: 20 74 68 61 74 20 6d 61 74 63 68 0a 74 68 65 20   that match.the 
3430: 65 78 70 72 65 73 73 69 6f 6e 20 61 72 65 20 72  expression are r
3440: 65 6d 6f 76 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a  emoved.</p>.}...
3450: 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20 49 4e  Section {DROP IN
3460: 44 45 58 7d 20 64 72 6f 70 69 6e 64 65 78 0a 0a  DEX} dropindex..
3470: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d  Syntax {sql-comm
3480: 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 49 4e 44 45  and} {.DROP INDE
3490: 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 0a 7d  X <index-name>.}
34a0: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
34b0: 44 52 4f 50 20 49 4e 44 45 58 20 73 74 61 74 65  DROP INDEX state
34c0: 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73 20 6f 66  ment consists of
34d0: 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22 44   the keywords "D
34e0: 52 4f 50 20 49 4e 44 45 58 22 20 66 6f 6c 6c 6f  ROP INDEX" follo
34f0: 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20  wed.by the name 
3500: 6f 66 20 74 68 65 20 69 6e 64 65 78 2e 20 20 54  of the index.  T
3510: 68 65 20 69 6e 64 65 78 20 6e 61 6d 65 64 20 69  he index named i
3520: 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 72 65 6d  s completely rem
3530: 6f 76 65 64 20 66 72 6f 6d 0a 74 68 65 20 64 69  oved from.the di
3540: 73 6b 2e 20 20 54 68 65 20 6f 6e 6c 79 20 77 61  sk.  The only wa
3550: 79 20 74 6f 20 72 65 63 6f 76 65 72 20 74 68 65  y to recover the
3560: 20 69 6e 64 65 78 20 69 73 20 74 6f 20 72 65 65   index is to ree
3570: 6e 74 65 72 20 74 68 65 0a 61 70 70 72 6f 70 72  nter the.appropr
3580: 69 61 74 65 20 43 52 45 41 54 45 20 49 4e 44 45  iate CREATE INDE
3590: 58 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 7d  X command.</p>.}
35a0: 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20  ..Section {DROP 
35b0: 54 41 42 4c 45 7d 20 64 72 6f 70 74 61 62 6c 65  TABLE} droptable
35c0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f  ..Syntax {sql-co
35d0: 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 54 41  mmand} {.DROP TA
35e0: 42 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  BLE <table-name>
35f0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
3600: 65 20 44 52 4f 50 20 54 41 42 4c 45 20 73 74 61  e DROP TABLE sta
3610: 74 65 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73 20  tement consists 
3620: 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20  of the keywords 
3630: 22 44 52 4f 50 20 54 41 42 4c 45 22 20 66 6f 6c  "DROP TABLE" fol
3640: 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d  lowed.by the nam
3650: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 20  e of the table. 
3660: 20 54 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 64   The table named
3670: 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 72   is completely r
3680: 65 6d 6f 76 65 64 20 66 72 6f 6d 0a 74 68 65 20  emoved from.the 
3690: 64 69 73 6b 2e 20 20 54 68 65 20 74 61 62 6c 65  disk.  The table
36a0: 20 63 61 6e 20 6e 6f 74 20 62 65 20 72 65 63 6f   can not be reco
36b0: 76 65 72 65 64 2e 20 20 41 6c 6c 20 69 6e 64 69  vered.  All indi
36c0: 63 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77  ces associated w
36d0: 69 74 68 0a 74 68 65 20 74 61 62 6c 65 20 61 72  ith.the table ar
36e0: 65 20 61 6c 73 6f 20 64 65 6c 65 74 65 64 2e 3c  e also deleted.<
36f0: 2f 70 3e 7d 0a 0a 53 65 63 74 69 6f 6e 20 45 58  /p>}..Section EX
3700: 50 4c 41 49 4e 20 65 78 70 6c 61 69 6e 0a 0a 53  PLAIN explain..S
3710: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
3720: 6d 65 6e 74 7d 20 7b 0a 45 58 50 4c 41 49 4e 20  ment} {.EXPLAIN 
3730: 3c 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 0a  <sql-statement>.
3740: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
3750: 20 45 58 50 4c 41 49 4e 20 63 6f 6d 6d 61 6e 64   EXPLAIN command
3760: 20 6d 6f 64 69 66 69 65 72 20 69 73 20 61 20 6e   modifier is a n
3770: 6f 6e 2d 73 74 61 6e 64 61 72 64 20 65 78 74 65  on-standard exte
3780: 6e 73 69 6f 6e 2e 20 20 54 68 65 0a 69 64 65 61  nsion.  The.idea
3790: 20 63 6f 6d 65 73 20 66 72 6f 6d 20 61 20 73 69   comes from a si
37a0: 6d 69 6c 61 72 20 63 6f 6d 6d 61 6e 64 20 66 6f  milar command fo
37b0: 75 6e 64 20 69 6e 20 50 6f 73 74 67 72 65 53 51  und in PostgreSQ
37c0: 4c 2c 20 62 75 74 20 74 68 65 20 6f 70 65 72 61  L, but the opera
37d0: 74 69 6f 6e 0a 69 73 20 63 6f 6d 70 6c 65 74 65  tion.is complete
37e0: 6c 79 20 64 69 66 66 65 72 65 6e 74 2e 3c 2f 70  ly different.</p
37f0: 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20 45 58 50  >..<p>If the EXP
3800: 4c 41 49 4e 20 6b 65 79 77 6f 72 64 20 61 70 70  LAIN keyword app
3810: 65 61 72 73 20 62 65 66 6f 72 65 20 61 6e 79 20  ears before any 
3820: 6f 74 68 65 72 20 53 51 4c 69 74 65 20 53 51 4c  other SQLite SQL
3830: 20 63 6f 6d 6d 61 6e 64 0a 74 68 65 6e 20 69 6e   command.then in
3840: 73 74 65 61 64 20 6f 66 20 61 63 74 75 61 6c 6c  stead of actuall
3850: 79 20 65 78 65 63 75 74 69 6e 67 20 74 68 65 20  y executing the 
3860: 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 20 53 51 4c  command, the SQL
3870: 69 74 65 20 6c 69 62 72 61 72 79 20 77 69 6c 6c  ite library will
3880: 0a 72 65 70 6f 72 74 20 62 61 63 6b 20 74 68 65  .report back the
3890: 20 73 65 71 75 65 6e 63 65 20 6f 66 20 76 69 72   sequence of vir
38a0: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 69 6e 73  tual machine ins
38b0: 74 72 75 63 74 69 6f 6e 73 20 69 74 20 77 6f 75  tructions it wou
38c0: 6c 64 20 68 61 76 65 0a 75 73 65 64 20 74 6f 20  ld have.used to 
38d0: 65 78 65 63 75 74 65 20 74 68 65 20 63 6f 6d 6d  execute the comm
38e0: 61 6e 64 20 68 61 64 20 74 68 65 20 45 58 50 4c  and had the EXPL
38f0: 41 49 4e 20 6b 65 79 77 6f 72 64 20 6e 6f 74 20  AIN keyword not 
3900: 62 65 65 6e 20 70 72 65 73 65 6e 74 2e 0a 46 6f  been present..Fo
3910: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
3920: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 76  ormation about v
3930: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 69  irtual machine i
3940: 6e 73 74 72 75 63 74 69 6f 6e 73 20 73 65 65 0a  nstructions see.
3950: 74 68 65 20 3c 61 20 68 72 65 66 3d 22 61 72 63  the <a href="arc
3960: 68 2e 68 74 6d 6c 22 3e 61 72 63 68 69 74 65 63  h.html">architec
3970: 74 75 72 65 20 64 65 73 63 72 69 70 74 69 6f 6e  ture description
3980: 3c 2f 61 3e 20 6f 72 20 74 68 65 20 64 6f 63 75  </a> or the docu
3990: 6d 65 6e 74 61 74 69 6f 6e 0a 6f 6e 20 3c 61 20  mentation.on <a 
39a0: 68 72 65 66 3d 22 6f 70 63 6f 64 65 2e 68 74 6d  href="opcode.htm
39b0: 6c 22 3e 61 76 61 69 6c 61 62 6c 65 20 6f 70 63  l">available opc
39c0: 6f 64 65 73 3c 2f 61 3e 20 66 6f 72 20 74 68 65  odes</a> for the
39d0: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
39e0: 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
39f0: 20 65 78 70 72 65 73 73 69 6f 6e 20 65 78 70 72   expression expr
3a00: 0a 0a 53 79 6e 74 61 78 20 7b 65 78 70 72 65 73  ..Syntax {expres
3a10: 73 69 6f 6e 7d 20 7b 0a 3c 65 78 70 72 65 73 73  sion} {.<express
3a20: 69 6f 6e 3e 20 3c 62 69 6e 61 72 79 2d 6f 70 3e  ion> <binary-op>
3a30: 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a   <expression> |.
3a40: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 3c 6c 69  <expression> <li
3a50: 6b 65 2d 6f 70 3e 20 3c 65 78 70 72 65 73 73 69  ke-op> <expressi
3a60: 6f 6e 3e 20 7c 0a 3c 75 6e 61 72 79 2d 6f 70 3e  on> |.<unary-op>
3a70: 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a   <expression> |.
3a80: 28 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 29  ( <expression> )
3a90: 20 7c 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e   |.<column-name>
3aa0: 20 7c 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20   |.<table-name> 
3ab0: 2e 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20  . <column-name> 
3ac0: 7c 0a 3c 6c 69 74 65 72 61 6c 2d 76 61 6c 75 65  |.<literal-value
3ad0: 3e 20 7c 0a 3c 66 75 6e 63 74 69 6f 6e 2d 6e 61  > |.<function-na
3ae0: 6d 65 3e 20 28 20 3c 65 78 70 72 2d 6c 69 73 74  me> ( <expr-list
3af0: 3e 20 7c 20 53 54 41 52 20 29 20 7c 0a 3c 65 78  > | STAR ) |.<ex
3b00: 70 72 65 73 73 69 6f 6e 3e 20 49 53 4e 55 4c 4c  pression> ISNULL
3b10: 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20   |.<expression> 
3b20: 4e 4f 54 4e 55 4c 4c 20 7c 0a 3c 65 78 70 72 65  NOTNULL |.<expre
3b30: 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d 20 42 45 54  ssion> [NOT] BET
3b40: 57 45 45 4e 20 3c 65 78 70 72 65 73 73 69 6f 6e  WEEN <expression
3b50: 3e 20 41 4e 44 20 3c 65 78 70 72 65 73 73 69 6f  > AND <expressio
3b60: 6e 3e 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e  n> |.<expression
3b70: 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28 20 3c 76 61  > [NOT] IN ( <va
3b80: 6c 75 65 2d 6c 69 73 74 3e 20 29 20 7c 0a 3c 65  lue-list> ) |.<e
3b90: 78 70 72 65 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d  xpression> [NOT]
3ba0: 20 49 4e 20 28 20 3c 73 65 6c 65 63 74 3e 20 29   IN ( <select> )
3bb0: 20 7c 0a 28 20 3c 73 65 6c 65 63 74 3e 20 29 0a   |.( <select> ).
3bc0: 7d 20 7b 6c 69 6b 65 2d 6f 70 7d 20 7b 0a 4c 49  } {like-op} {.LI
3bd0: 4b 45 20 7c 20 47 4c 4f 42 20 7c 20 4e 4f 54 20  KE | GLOB | NOT 
3be0: 4c 49 4b 45 20 7c 20 4e 4f 54 20 47 4c 4f 42 0a  LIKE | NOT GLOB.
3bf0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 69  }..puts {.<p>Thi
3c00: 73 20 73 65 63 74 69 6f 6e 20 69 73 20 64 69 66  s section is dif
3c10: 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65 20  ferent from the 
3c20: 6f 74 68 65 72 73 2e 20 20 4d 6f 73 74 20 6f 74  others.  Most ot
3c30: 68 65 72 20 73 65 63 74 69 6f 6e 73 20 6f 66 0a  her sections of.
3c40: 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 74 61  this document ta
3c50: 6c 6b 73 20 61 62 6f 75 74 20 61 20 70 61 72 74  lks about a part
3c60: 69 63 75 6c 61 72 20 53 51 4c 20 63 6f 6d 6d 61  icular SQL comma
3c70: 6e 64 2e 20 20 54 68 69 73 20 73 65 63 74 69 6f  nd.  This sectio
3c80: 6e 20 64 6f 65 73 0a 6e 6f 74 20 74 61 6c 6b 20  n does.not talk 
3c90: 61 62 6f 75 74 20 61 20 73 74 61 6e 64 61 6c 6f  about a standalo
3ca0: 6e 65 20 63 6f 6d 6d 61 6e 64 20 62 75 74 20 61  ne command but a
3cb0: 62 6f 75 74 20 22 65 78 70 72 65 73 73 69 6f 6e  bout "expression
3cc0: 73 22 20 77 68 69 63 68 20 61 72 65 20 0a 73 75  s" which are .su
3cd0: 62 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 6d 6f  bcomponent of mo
3ce0: 73 74 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64  st other command
3cf0: 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51 4c 69 74  s.</p>..<p>SQLit
3d00: 65 20 75 6e 64 65 72 73 74 61 6e 64 73 20 74 68  e understands th
3d10: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e 61  e following bina
3d20: 72 79 20 6f 70 65 72 61 74 6f 72 73 2c 20 69 6e  ry operators, in
3d30: 20 6f 72 64 65 72 20 66 72 6f 6d 0a 68 69 67 68   order from.high
3d40: 65 73 74 20 74 6f 20 6c 6f 77 65 73 74 20 70 72  est to lowest pr
3d50: 65 63 65 64 65 6e 63 65 3a 3c 2f 70 3e 0a 0a 3c  ecedence:</p>..<
3d60: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e  blockquote><pre>
3d70: 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32  .<font color="#2
3d80: 63 32 63 66 30 22 3e 3c 62 69 67 3e 2a 20 20 20  c2cf0"><big>*   
3d90: 20 2f 20 20 20 20 25 0a 2b 20 20 20 20 2d 0a 26   /    %.+    -.&
3da0: 6c 74 3b 26 6c 74 3b 20 20 20 26 67 74 3b 26 67  lt;&lt;   &gt;&g
3db0: 74 3b 20 20 20 26 61 6d 70 3b 20 20 20 20 7c 0a  t;   &amp;    |.
3dc0: 26 6c 74 3b 20 20 20 20 26 6c 74 3b 3d 20 20 20  &lt;    &lt;=   
3dd0: 26 67 74 3b 20 20 20 20 26 67 74 3b 3d 0a 3d 20  &gt;    &gt;=.= 
3de0: 20 20 20 3d 3d 20 20 20 21 3d 20 20 20 26 6c 74     ==   !=   &lt
3df0: 3b 26 67 74 3b 20 20 20 3c 2f 62 69 67 3e 49 4e  ;&gt;   </big>IN
3e00: 0a 41 4e 44 0a 4f 52 3c 2f 66 6f 6e 74 3e 0a 3c  .AND.OR</font>.<
3e10: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
3e20: 65 3e 0a 0a 3c 70 3e 53 75 70 70 6f 72 74 65 64  e>..<p>Supported
3e30: 20 75 6e 61 72 79 20 6f 70 65 72 61 74 65 72 73   unary operaters
3e40: 20 61 72 65 20 74 68 65 73 65 3a 3c 2f 70 3e 0a   are these:</p>.
3e50: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
3e60: 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22  e>.<font color="
3e70: 23 32 63 32 63 66 30 22 3e 3c 62 69 67 3e 2d 20  #2c2cf0"><big>- 
3e80: 20 20 20 2b 20 20 20 20 21 20 20 20 20 7e 3c 2f     +    !    ~</
3e90: 62 69 67 3e 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72  big></font>.</pr
3ea0: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
3eb0: 0a 3c 70 3e 41 6e 79 20 53 51 4c 69 74 65 20 76  .<p>Any SQLite v
3ec0: 61 6c 75 65 20 63 61 6e 20 62 65 20 75 73 65 64  alue can be used
3ed0: 20 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 65   as part of an e
3ee0: 78 70 72 65 73 73 69 6f 6e 2e 20 20 0a 46 6f 72  xpression.  .For
3ef0: 20 61 72 69 74 68 6d 65 74 69 63 20 6f 70 65 72   arithmetic oper
3f00: 61 74 69 6f 6e 73 2c 20 69 6e 74 65 67 65 72 73  ations, integers
3f10: 20 61 72 65 20 74 72 65 61 74 65 64 20 61 73 20   are treated as 
3f20: 69 6e 74 65 67 65 72 73 2e 0a 53 74 72 69 6e 67  integers..String
3f30: 73 20 61 72 65 20 66 69 72 73 74 20 63 6f 6e 76  s are first conv
3f40: 65 72 74 65 64 20 74 6f 20 72 65 61 6c 20 6e 75  erted to real nu
3f50: 6d 62 65 72 73 20 75 73 69 6e 67 20 3c 62 3e 61  mbers using <b>a
3f60: 74 6f 66 28 29 3c 2f 62 3e 2e 0a 46 6f 72 20 63  tof()</b>..For c
3f70: 6f 6d 70 61 72 69 73 6f 6e 20 6f 70 65 72 61 74  omparison operat
3f80: 6f 72 73 2c 20 6e 75 6d 62 65 72 73 20 63 6f 6d  ors, numbers com
3f90: 70 61 72 65 20 61 73 20 6e 75 6d 62 65 72 73 20  pare as numbers 
3fa0: 61 6e 64 20 73 74 72 69 6e 67 73 0a 63 6f 6d 70  and strings.comp
3fb0: 61 72 65 20 61 73 20 73 74 72 69 6e 67 73 2e 20  are as strings. 
3fc0: 20 46 6f 72 20 73 74 72 69 6e 67 20 63 6f 6d 70   For string comp
3fd0: 61 72 69 73 6f 6e 73 2c 20 63 61 73 65 20 69 73  arisons, case is
3fe0: 20 73 69 67 6e 69 66 69 63 61 6e 74 0a 62 75 74   significant.but
3ff0: 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 74 6f   is only used to
4000: 20 62 72 65 61 6b 20 61 20 74 69 65 2e 0a 4e 6f   break a tie..No
4010: 74 65 20 74 68 61 74 20 74 68 65 72 65 20 61 72  te that there ar
4020: 65 20 74 77 6f 20 76 61 72 69 61 74 69 6f 6e 73  e two variations
4030: 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73 20 61   of the equals a
4040: 6e 64 20 6e 6f 74 20 65 71 75 61 6c 73 0a 6f 70  nd not equals.op
4050: 65 72 61 74 6f 72 73 2e 20 20 45 71 75 61 6c 73  erators.  Equals
4060: 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 7d 0a   can be either}.
4070: 70 75 74 73 20 22 5b 4f 70 65 72 61 74 6f 72 20  puts "[Operator 
4080: 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74 6f 72 20  =] or [Operator 
4090: 3d 3d 5d 2e 0a 54 68 65 20 6e 6f 6e 2d 65 71 75  ==]..The non-equ
40a0: 61 6c 73 20 6f 70 65 72 61 74 6f 72 20 63 61 6e  als operator can
40b0: 20 62 65 20 65 69 74 68 65 72 0a 5b 4f 70 65 72   be either.[Oper
40c0: 61 74 6f 72 20 21 3d 5d 20 6f 72 20 5b 4f 70 65  ator !=] or [Ope
40d0: 72 61 74 6f 72 20 7b 26 6c 74 3b 26 67 74 3b 7d  rator {&lt;&gt;}
40e0: 5d 2e 3c 2f 70 3e 22 0a 70 75 74 73 20 7b 0a 0a  ].</p>".puts {..
40f0: 3c 70 3e 54 68 65 20 4c 49 4b 45 20 6f 70 65 72  <p>The LIKE oper
4100: 61 74 6f 72 20 64 6f 65 73 20 61 20 77 69 6c 64  ator does a wild
4110: 63 61 72 64 20 63 6f 6d 70 61 72 69 73 69 6f 6e  card comparision
4120: 2e 20 20 54 68 65 20 6f 70 65 72 61 6e 64 0a 74  .  The operand.t
4130: 6f 20 74 68 65 20 72 69 67 68 74 20 63 6f 6e 74  o the right cont
4140: 61 69 6e 73 20 74 68 65 20 77 69 6c 64 63 61 72  ains the wildcar
4150: 64 73 2e 7d 0a 70 75 74 73 20 22 41 20 70 65 72  ds.}.puts "A per
4160: 63 65 6e 74 20 73 79 6d 62 6f 6c 20 5b 4f 70 65  cent symbol [Ope
4170: 72 61 74 6f 72 20 25 5d 20 69 6e 20 74 68 65 20  rator %] in the 
4180: 72 69 67 68 74 20 6f 70 65 72 61 6e 64 0a 6d 61  right operand.ma
4190: 74 63 68 65 73 20 61 6e 79 20 73 65 71 75 65 6e  tches any sequen
41a0: 63 65 20 6f 66 20 7a 65 72 6f 20 6f 72 20 6d 6f  ce of zero or mo
41b0: 72 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e  re characters on
41c0: 20 74 68 65 20 6c 65 66 74 2e 0a 41 6e 20 75 6e   the left..An un
41d0: 64 65 72 73 63 6f 72 65 20 5b 4f 70 65 72 61 74  derscore [Operat
41e0: 6f 72 20 5f 5d 20 6f 6e 20 74 68 65 20 72 69 67  or _] on the rig
41f0: 68 74 0a 6d 61 74 63 68 65 73 20 61 6e 79 20 73  ht.matches any s
4200: 69 6e 67 6c 65 20 63 68 61 72 61 63 74 65 72 20  ingle character 
4210: 6f 6e 20 74 68 65 20 6c 65 66 74 2e 22 0a 70 75  on the left.".pu
4220: 74 73 20 7b 54 68 65 20 4c 49 4b 45 20 6f 70 65  ts {The LIKE ope
4230: 72 61 74 6f 72 20 69 73 0a 6e 6f 74 20 63 61 73  rator is.not cas
4240: 65 20 73 65 6e 73 69 74 69 76 65 20 61 6e 64 20  e sensitive and 
4250: 77 69 6c 6c 20 6d 61 74 63 68 20 75 70 70 65 72  will match upper
4260: 20 63 61 73 65 20 63 68 61 72 61 63 74 65 72 73   case characters
4270: 20 6f 6e 20 6f 6e 65 0a 73 69 64 65 20 61 67 61   on one.side aga
4280: 69 6e 73 74 20 6c 6f 77 65 72 20 63 61 73 65 20  inst lower case 
4290: 63 68 61 72 61 63 74 65 72 73 20 6f 6e 20 74 68  characters on th
42a0: 65 20 6f 74 68 65 72 2e 0a 28 41 20 62 75 67 3a  e other..(A bug:
42b0: 20 53 51 4c 69 74 65 20 6f 6e 6c 79 20 75 6e 64   SQLite only und
42c0: 65 72 73 74 61 6e 64 73 20 75 70 70 65 72 2f 6c  erstands upper/l
42d0: 6f 77 65 72 20 63 61 73 65 20 66 6f 72 20 37 2d  ower case for 7-
42e0: 62 69 74 20 4c 61 74 69 6e 0a 63 68 61 72 61 63  bit Latin.charac
42f0: 74 65 72 73 2e 20 20 48 65 6e 63 65 20 74 68 65  ters.  Hence the
4300: 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72 20 69   LIKE operator i
4310: 73 20 63 61 73 65 20 73 65 6e 73 69 74 69 76 65  s case sensitive
4320: 20 66 6f 72 0a 38 2d 62 69 74 20 69 73 6f 38 38   for.8-bit iso88
4330: 35 39 20 63 68 61 72 61 63 74 65 72 73 20 6f 72  59 characters or
4340: 20 55 54 46 2d 38 20 63 68 61 72 61 63 74 65 72   UTF-8 character
4350: 73 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c  s.  For example,
4360: 0a 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20  .the expression 
4370: 3c 62 3e 27 61 27 26 6e 62 73 70 3b 4c 49 4b 45  <b>'a'&nbsp;LIKE
4380: 26 6e 62 73 70 3b 27 41 27 3c 2f 62 3e 20 69 73  &nbsp;'A'</b> is
4390: 20 54 52 55 45 20 62 75 74 0a 3c 62 3e 27 26 61   TRUE but.<b>'&a
43a0: 65 6c 69 67 3b 27 26 6e 62 73 70 3b 4c 49 4b 45  elig;'&nbsp;LIKE
43b0: 26 6e 62 73 70 3b 27 26 41 45 6c 69 67 3b 27 3c  &nbsp;'&AElig;'<
43c0: 2f 62 3e 20 69 73 20 46 41 4c 53 45 2e 29 0a 3c  /b> is FALSE.).<
43d0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47 4c 4f 42  /p>..<p>The GLOB
43e0: 20 6f 70 65 72 61 74 6f 72 20 69 73 20 73 69 6d   operator is sim
43f0: 69 6c 61 72 20 74 6f 20 4c 49 4b 45 20 62 75 74  ilar to LIKE but
4400: 20 75 73 65 73 20 74 68 65 20 55 6e 69 78 0a 66   uses the Unix.f
4410: 69 6c 65 20 67 6c 6f 62 62 69 6e 67 20 73 79 6e  ile globbing syn
4420: 74 61 78 20 66 6f 72 20 69 74 73 20 77 69 6c 64  tax for its wild
4430: 63 61 72 64 73 2e 20 20 41 6c 73 6f 2c 20 47 4c  cards.  Also, GL
4440: 4f 42 20 69 73 20 63 61 73 65 0a 73 65 6e 73 69  OB is case.sensi
4450: 74 69 76 65 2c 20 75 6e 6c 69 6b 65 20 4c 49 4b  tive, unlike LIK
4460: 45 2e 20 20 42 6f 74 68 20 47 4c 4f 42 20 61 6e  E.  Both GLOB an
4470: 64 20 4c 49 4b 45 20 6d 61 79 20 62 65 20 70 72  d LIKE may be pr
4480: 65 63 65 64 65 64 20 62 79 0a 74 68 65 20 4e 4f  eceded by.the NO
4490: 54 20 6b 65 79 77 6f 72 64 20 74 6f 20 69 6e 76  T keyword to inv
44a0: 65 72 74 20 74 68 65 20 73 65 6e 73 65 20 6f 66  ert the sense of
44b0: 20 74 68 65 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a   the test.</p>..
44c0: 3c 70 3e 41 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65  <p>A column name
44d0: 20 63 61 6e 20 62 65 20 61 6e 79 20 6f 66 20 74   can be any of t
44e0: 68 65 20 6e 61 6d 65 73 20 64 65 66 69 6e 65 64  he names defined
44f0: 20 69 6e 20 74 68 65 20 43 52 45 41 54 45 20 54   in the CREATE T
4500: 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e 74 20 6f  ABLE.statement o
4510: 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c  r one of the fol
4520: 6c 6f 77 69 6e 67 20 73 70 65 63 69 61 6c 20 69  lowing special i
4530: 64 65 6e 74 69 66 69 65 72 73 3a 20 22 3c 62 3e  dentifiers: "<b>
4540: 52 4f 57 49 44 3c 2f 62 3e 22 2c 0a 22 3c 62 3e  ROWID</b>",."<b>
4550: 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20 22 3c 62  OID</b>", or "<b
4560: 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54  >_ROWID_</b>"..T
4570: 68 65 73 65 20 73 70 65 63 69 61 6c 20 69 64 65  hese special ide
4580: 6e 74 69 66 69 65 72 73 20 61 6c 6c 20 64 65 73  ntifiers all des
4590: 63 72 69 62 65 20 74 68 65 0a 75 6e 69 71 75 65  cribe the.unique
45a0: 20 72 61 6e 64 6f 6d 20 69 6e 74 65 67 65 72 20   random integer 
45b0: 6b 65 79 20 28 74 68 65 20 22 72 6f 77 20 6b 65  key (the "row ke
45c0: 79 22 29 20 61 73 73 6f 63 69 61 74 65 64 20 77  y") associated w
45d0: 69 74 68 20 65 76 65 72 79 20 0a 72 6f 77 20 6f  ith every .row o
45e0: 66 20 65 76 65 72 79 20 74 61 62 6c 65 2e 0a 54  f every table..T
45f0: 68 65 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74  he special ident
4600: 69 66 69 65 72 73 20 6f 6e 6c 79 20 72 65 66 65  ifiers only refe
4610: 72 20 74 6f 20 74 68 65 20 72 6f 77 20 6b 65 79  r to the row key
4620: 20 69 66 20 74 68 65 20 43 52 45 41 54 45 20 54   if the CREATE T
4630: 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e 74 20 64  ABLE.statement d
4640: 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 20 61  oes not define a
4650: 20 72 65 61 6c 20 63 6f 6c 75 6d 6e 20 77 69 74   real column wit
4660: 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 2e  h the same name.
4670: 20 20 52 6f 77 20 6b 65 79 73 0a 61 63 74 20 6c    Row keys.act l
4680: 69 6b 65 20 72 65 61 64 2d 6f 6e 6c 79 20 63 6f  ike read-only co
4690: 6c 75 6d 6e 73 2e 20 20 41 20 72 6f 77 20 6b 65  lumns.  A row ke
46a0: 79 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 6e  y can be used an
46b0: 79 77 68 65 72 65 20 61 20 72 65 67 75 6c 61 72  ywhere a regular
46c0: 0a 63 6f 6c 75 6d 6e 20 63 61 6e 20 62 65 20 75  .column can be u
46d0: 73 65 64 2c 20 65 78 63 65 70 74 20 74 68 61 74  sed, except that
46e0: 20 79 6f 75 20 63 61 6e 6e 6f 74 20 63 68 61 6e   you cannot chan
46f0: 67 65 20 74 68 65 20 76 61 6c 75 65 0a 6f 66 20  ge the value.of 
4700: 61 20 72 6f 77 20 6b 65 79 20 69 6e 20 61 6e 20  a row key in an 
4710: 55 50 44 41 54 45 20 6f 72 20 49 4e 53 45 52 54  UPDATE or INSERT
4720: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 22 53 45 4c   statement.."SEL
4730: 45 43 54 20 2a 20 2e 2e 2e 22 20 64 6f 65 73 20  ECT * ..." does 
4740: 6e 6f 74 20 72 65 74 75 72 6e 20 74 68 65 20 72  not return the r
4750: 6f 77 20 6b 65 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e  ow key.</p>..<p>
4760: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74  SELECT statement
4770: 73 20 63 61 6e 20 61 70 70 65 61 72 20 69 6e 20  s can appear in 
4780: 65 78 70 72 65 73 73 69 6f 6e 73 20 61 73 20 65  expressions as e
4790: 69 74 68 65 72 20 74 68 65 0a 72 69 67 68 74 2d  ither the.right-
47a0: 68 61 6e 64 20 6f 70 65 72 61 6e 64 20 6f 66 20  hand operand of 
47b0: 74 68 65 20 49 4e 20 6f 70 65 72 61 74 6f 72 20  the IN operator 
47c0: 6f 72 20 61 73 20 61 20 73 63 61 6c 61 72 20 71  or as a scalar q
47d0: 75 61 6e 74 69 74 79 2e 0a 49 6e 20 62 6f 74 68  uantity..In both
47e0: 20 63 61 73 65 73 2c 20 74 68 65 20 53 45 4c 45   cases, the SELE
47f0: 43 54 20 73 68 6f 75 6c 64 20 68 61 76 65 20 6f  CT should have o
4800: 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c  nly a single col
4810: 75 6d 6e 20 69 6e 20 69 74 73 0a 72 65 73 75 6c  umn in its.resul
4820: 74 2e 20 20 43 6f 6d 70 6f 75 6e 64 20 53 45 4c  t.  Compound SEL
4830: 45 43 54 73 20 28 63 6f 6e 6e 65 63 74 65 64 20  ECTs (connected 
4840: 77 69 74 68 20 6b 65 79 77 6f 72 64 73 20 6c 69  with keywords li
4850: 6b 65 20 55 4e 49 4f 4e 20 6f 72 0a 45 58 43 45  ke UNION or.EXCE
4860: 50 54 29 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e  PT) are allowed.
4870: 20 20 41 6e 79 20 4f 52 44 45 52 20 42 59 20 63    Any ORDER BY c
4880: 6c 61 75 73 65 20 6f 6e 20 74 68 65 20 73 65 6c  lause on the sel
4890: 65 63 74 20 69 73 20 69 67 6e 6f 72 65 64 2e 0a  ect is ignored..
48a0: 41 20 53 45 4c 45 43 54 20 69 6e 20 61 6e 20 65  A SELECT in an e
48b0: 78 70 72 65 73 73 69 6f 6e 20 69 73 20 65 76 61  xpression is eva
48c0: 6c 75 61 74 65 64 20 6f 6e 63 65 20 62 65 66 6f  luated once befo
48d0: 72 65 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f  re any other pro
48e0: 63 65 73 73 69 6e 67 0a 69 73 20 70 65 72 66 6f  cessing.is perfo
48f0: 72 6d 65 64 2c 20 73 6f 20 6e 6f 6e 65 20 6f 66  rmed, so none of
4900: 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73   the expressions
4910: 20 77 69 74 68 69 6e 20 74 68 65 20 73 65 6c 65   within the sele
4920: 63 74 20 69 74 73 65 6c 66 20 63 61 6e 0a 72 65  ct itself can.re
4930: 66 65 72 20 74 6f 20 71 75 61 6e 74 69 74 69 65  fer to quantitie
4940: 73 20 69 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e  s in the contain
4950: 69 6e 67 20 65 78 70 72 65 73 73 69 6f 6e 2e 3c  ing expression.<
4960: 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53  /p>..<p>When a S
4970: 45 4c 45 43 54 20 69 73 20 74 68 65 20 72 69 67  ELECT is the rig
4980: 68 74 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68  ht operand of th
4990: 65 20 49 4e 20 6f 70 65 72 61 74 6f 72 2c 20 74  e IN operator, t
49a0: 68 65 20 49 4e 0a 6f 70 65 72 61 74 6f 72 20 72  he IN.operator r
49b0: 65 74 75 72 6e 73 20 54 52 55 45 20 69 66 20 74  eturns TRUE if t
49c0: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65  he result of the
49d0: 20 6c 65 66 74 20 6f 70 65 72 61 6e 64 20 69 73   left operand is
49e0: 20 61 6e 79 20 6f 66 0a 74 68 65 20 76 61 6c 75   any of.the valu
49f0: 65 73 20 67 65 6e 65 72 61 74 65 64 20 62 79 20  es generated by 
4a00: 74 68 65 20 73 65 6c 65 63 74 2e 20 20 54 68 65  the select.  The
4a10: 20 49 4e 20 6f 70 65 72 61 74 6f 72 20 6d 61 79   IN operator may
4a20: 20 62 65 20 70 72 65 63 65 64 65 64 0a 62 79 20   be preceded.by 
4a30: 74 68 65 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20  the NOT keyword 
4a40: 74 6f 20 69 6e 76 65 72 74 20 74 68 65 20 73 65  to invert the se
4a50: 6e 73 65 20 6f 66 20 74 68 65 20 74 65 73 74 2e  nse of the test.
4a60: 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20  </p>..<p>When a 
4a70: 53 45 4c 45 43 54 20 61 70 70 65 61 72 73 20 77  SELECT appears w
4a80: 69 74 68 69 6e 20 61 6e 20 65 78 70 72 65 73 73  ithin an express
4a90: 69 6f 6e 20 62 75 74 20 69 73 20 6e 6f 74 20 74  ion but is not t
4aa0: 68 65 20 72 69 67 68 74 0a 6f 70 65 72 61 6e 64  he right.operand
4ab0: 20 6f 66 20 61 6e 20 49 4e 20 6f 70 65 72 61 74   of an IN operat
4ac0: 6f 72 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72  or, then the fir
4ad0: 73 74 20 72 6f 77 20 6f 66 20 74 68 65 20 72 65  st row of the re
4ae0: 73 75 6c 74 20 6f 66 20 74 68 65 0a 53 45 4c 45  sult of the.SELE
4af0: 43 54 20 62 65 63 6f 6d 65 73 20 74 68 65 20 76  CT becomes the v
4b00: 61 6c 75 65 20 75 73 65 64 20 69 6e 20 74 68 65  alue used in the
4b10: 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 49 66   expression.  If
4b20: 20 74 68 65 20 53 45 4c 45 43 54 20 79 69 65 6c   the SELECT yiel
4b30: 64 73 0a 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65  ds.more than one
4b40: 20 72 65 73 75 6c 74 20 72 6f 77 2c 20 61 6c 6c   result row, all
4b50: 20 72 6f 77 73 20 61 66 74 65 72 20 74 68 65 20   rows after the 
4b60: 66 69 72 73 74 20 61 72 65 20 69 67 6e 6f 72 65  first are ignore
4b70: 64 2e 20 20 49 66 0a 74 68 65 20 53 45 4c 45 43  d.  If.the SELEC
4b80: 54 20 79 65 69 6c 64 73 20 6e 6f 20 72 6f 77 73  T yeilds no rows
4b90: 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65  , then the value
4ba0: 20 6f 66 20 74 68 65 20 53 45 4c 45 43 54 20 69   of the SELECT i
4bb0: 73 20 4e 55 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e  s NULL.</p>..<p>
4bc0: 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 73  The expression s
4bd0: 79 6e 74 61 78 20 63 75 72 72 65 6e 74 6c 79 20  yntax currently 
4be0: 73 75 70 70 6f 72 74 73 20 74 68 65 20 66 6f 6c  supports the fol
4bf0: 6c 6f 77 69 6e 67 0a 66 75 6e 63 74 69 6f 6e 73  lowing.functions
4c00: 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f  :</p>..<blockquo
4c10: 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e 74 20 63  te><pre>.<font c
4c20: 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e 3c  olor="#2c2cf0"><
4c30: 62 69 67 3e 63 6f 75 6e 74 20 20 20 20 6d 69 6e  big>count    min
4c40: 20 20 20 20 20 20 20 6d 61 78 20 20 20 20 20 20         max      
4c50: 20 73 75 6d 0a 61 76 67 20 20 20 20 20 20 6c 65   sum.avg      le
4c60: 6e 67 74 68 20 20 20 20 73 75 62 73 74 72 20 20  ngth    substr  
4c70: 20 20 61 62 73 20 20 20 20 20 20 20 72 6f 75 6e    abs       roun
4c80: 64 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74 3e 0a 3c  d</big></font>.<
4c90: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
4ca0: 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66 75 6e 63  e>..<p>.The func
4cb0: 74 69 6f 6e 73 20 3c 62 3e 63 6f 75 6e 74 3c 2f  tions <b>count</
4cc0: 62 3e 2c 20 3c 62 3e 73 75 6d 3c 2f 62 3e 2c 20  b>, <b>sum</b>, 
4cd0: 61 6e 64 20 3c 62 3e 61 76 67 3c 2f 62 3e 20 61  and <b>avg</b> a
4ce0: 6e 64 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 73  nd the functions
4cf0: 0a 3c 62 3e 6d 69 6e 3c 2f 62 3e 20 61 6e 64 20  .<b>min</b> and 
4d00: 3c 62 3e 6d 61 78 3c 2f 62 3e 20 75 73 65 64 20  <b>max</b> used 
4d10: 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 20 61 72  with only one ar
4d20: 67 75 6d 65 6e 74 20 61 72 65 20 61 6c 6c 20 61  gument are all a
4d30: 67 67 72 65 67 61 74 65 0a 66 75 6e 63 74 69 6f  ggregate.functio
4d40: 6e 73 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20  ns.  This means 
4d50: 74 68 61 74 20 74 68 65 79 20 61 72 65 20 63 6f  that they are co
4d60: 6d 70 75 74 65 64 20 61 63 72 6f 73 73 20 61 6c  mputed across al
4d70: 6c 20 72 6f 77 73 20 6f 66 20 74 68 65 20 72 65  l rows of the re
4d80: 73 75 6c 74 2e 0a 54 68 65 20 66 75 6e 63 74 69  sult..The functi
4d90: 6f 6e 73 20 3c 62 3e 6d 69 6e 3c 2f 62 3e 20 61  ons <b>min</b> a
4da0: 6e 64 20 3c 62 3e 6d 61 78 3c 2f 62 3e 0a 77 69  nd <b>max</b>.wi
4db0: 74 68 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 61  th two or more a
4dc0: 72 67 75 6d 65 6e 74 73 20 61 6e 64 20 61 6c 6c  rguments and all
4dd0: 20 6f 74 68 65 72 20 66 75 6e 63 74 69 6f 6e 73   other functions
4de0: 0a 61 72 65 20 6e 6f 6e 2d 61 67 67 72 65 67 61  .are non-aggrega
4df0: 74 65 73 2e 20 20 4e 6f 6e 2d 61 67 67 72 65 67  tes.  Non-aggreg
4e00: 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 0a 61 72  ate functions.ar
4e10: 65 20 63 6f 6d 70 75 74 65 64 20 73 65 70 61 72  e computed separ
4e20: 61 74 65 6c 79 20 66 6f 72 20 65 61 63 68 20 72  ately for each r
4e30: 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ow of the result
4e40: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20  ..</p>..<p>.The 
4e50: 3c 62 3e 72 6f 75 6e 64 3c 2f 62 3e 20 66 75 6e  <b>round</b> fun
4e60: 63 74 69 6f 6e 20 63 61 6e 20 74 61 6b 65 20 65  ction can take e
4e70: 69 74 68 65 72 20 31 20 6f 72 20 32 20 61 72 67  ither 1 or 2 arg
4e80: 75 6d 65 6e 74 73 2e 20 20 54 68 65 0a 66 69 72  uments.  The.fir
4e90: 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74  st argument is t
4ea0: 68 65 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e  he floating poin
4eb0: 74 20 76 61 6c 75 65 20 74 68 61 74 20 69 73 20  t value that is 
4ec0: 72 6f 75 6e 64 65 64 2e 20 20 54 68 65 0a 73 65  rounded.  The.se
4ed0: 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73  cond argument is
4ee0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 64   the number of d
4ef0: 69 67 69 74 73 20 74 6f 20 74 68 65 20 72 69 67  igits to the rig
4f00: 68 74 20 6f 66 20 74 68 65 0a 64 65 63 69 6d 61  ht of the.decima
4f10: 6c 20 70 6f 69 6e 74 20 74 6f 20 70 72 65 73 65  l point to prese
4f20: 72 76 65 2e 20 20 49 66 20 74 68 65 20 73 65 63  rve.  If the sec
4f30: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20  ond argument is 
4f40: 6f 6d 69 74 74 65 64 2c 0a 7a 65 72 6f 20 69 73  omitted,.zero is
4f50: 20 61 73 73 75 6d 65 64 2e 20 20 53 6f 20 72 6f   assumed.  So ro
4f60: 75 6e 64 28 31 2e 32 33 34 35 36 2c 32 29 20 69  und(1.23456,2) i
4f70: 73 20 31 2e 32 33 20 61 6e 64 0a 72 6f 75 6e 64  s 1.23 and.round
4f80: 28 31 32 2e 33 34 2c 30 29 20 61 6e 64 20 72 6f  (12.34,0) and ro
4f90: 75 6e 64 28 31 32 2e 33 34 29 20 62 6f 74 68 20  und(12.34) both 
4fa0: 65 76 61 6c 75 61 74 65 20 74 6f 20 31 32 2e 0a  evaluate to 12..
4fb0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 22 3c  </p>..<p>.The "<
4fc0: 62 3e 63 6f 75 6e 74 28 2a 29 3c 2f 62 3e 22 20  b>count(*)</b>" 
4fd0: 73 79 6e 74 61 78 20 69 73 20 73 75 70 70 6f 72  syntax is suppor
4fe0: 74 65 64 20 62 75 74 0a 22 3c 62 3e 63 6f 75 6e  ted but."<b>coun
4ff0: 74 28 64 69 73 74 69 6e 63 74 3c 2f 62 3e 20 3c  t(distinct</b> <
5000: 69 3e 43 4f 4c 55 4d 4e 2d 4e 41 4d 45 3c 2f 69  i>COLUMN-NAME</i
5010: 3e 3c 62 3e 29 3c 2f 62 3e 22 20 69 73 20 6e 6f  ><b>)</b>" is no
5020: 74 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69  t..</p>.}..Secti
5030: 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73 65 72 74  on INSERT insert
5040: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
5050: 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e 53 45 52  atement} {.INSER
5060: 54 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  T [ <conflict-cl
5070: 61 75 73 65 3e 20 5d 20 49 4e 54 4f 20 3c 74 61  ause> ] INTO <ta
5080: 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63 6f  ble-name> [( <co
5090: 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 56 41  lumn-list> )] VA
50a0: 4c 55 45 53 20 28 20 3c 76 61 6c 75 65 2d 6c 69  LUES ( <value-li
50b0: 73 74 3e 20 29 20 7c 0a 49 4e 53 45 52 54 20 5b  st> ) |.INSERT [
50c0: 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73   <conflict-claus
50d0: 65 3e 20 5d 20 49 4e 54 4f 20 3c 74 61 62 6c 65  e> ] INTO <table
50e0: 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63 6f 6c 75 6d  -name> [( <colum
50f0: 6e 2d 6c 69 73 74 3e 20 29 5d 20 3c 73 65 6c 65  n-list> )] <sele
5100: 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d 0a  ct-statement>.}.
5110: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 49  .puts {.<p>The I
5120: 4e 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74 20  NSERT statement 
5130: 63 6f 6d 65 73 20 69 6e 20 74 77 6f 20 62 61 73  comes in two bas
5140: 69 63 20 66 6f 72 6d 73 2e 20 20 54 68 65 20 66  ic forms.  The f
5150: 69 72 73 74 20 66 6f 72 6d 0a 28 77 69 74 68 20  irst form.(with 
5160: 74 68 65 20 22 56 41 4c 55 45 53 22 20 6b 65 79  the "VALUES" key
5170: 77 6f 72 64 29 20 63 72 65 61 74 65 73 20 61 20  word) creates a 
5180: 73 69 6e 67 6c 65 20 6e 65 77 20 72 6f 77 20 69  single new row i
5190: 6e 20 61 6e 20 65 78 69 73 74 69 6e 67 20 74 61  n an existing ta
51a0: 62 6c 65 2e 0a 49 66 20 6e 6f 20 63 6f 6c 75 6d  ble..If no colum
51b0: 6e 2d 6c 69 73 74 20 69 73 20 73 70 65 63 69 66  n-list is specif
51c0: 69 65 64 20 74 68 65 6e 20 74 68 65 20 6e 75 6d  ied then the num
51d0: 62 65 72 20 6f 66 20 76 61 6c 75 65 73 20 6d 75  ber of values mu
51e0: 73 74 0a 62 65 20 74 68 65 20 73 61 6d 65 20 61  st.be the same a
51f0: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
5200: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74  columns in the t
5210: 61 62 6c 65 2e 20 20 49 66 20 61 20 63 6f 6c 75  able.  If a colu
5220: 6d 6e 2d 6c 69 73 74 0a 69 73 20 73 70 65 63 69  mn-list.is speci
5230: 66 69 65 64 2c 20 74 68 65 6e 20 74 68 65 20 6e  fied, then the n
5240: 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73 20  umber of values 
5250: 6d 75 73 74 20 6d 61 74 63 68 20 74 68 65 20 6e  must match the n
5260: 75 6d 62 65 72 20 6f 66 0a 73 70 65 63 69 66 69  umber of.specifi
5270: 65 64 20 63 6f 6c 75 6d 6e 73 2e 20 20 43 6f 6c  ed columns.  Col
5280: 75 6d 6e 73 20 6f 66 20 74 68 65 20 74 61 62 6c  umns of the tabl
5290: 65 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 61 70  e that do not ap
52a0: 70 65 61 72 20 69 6e 20 74 68 65 0a 63 6f 6c 75  pear in the.colu
52b0: 6d 6e 20 6c 69 73 74 20 61 72 65 20 66 69 6c 6c  mn list are fill
52c0: 20 77 69 74 68 20 74 68 65 20 64 65 66 61 75 6c   with the defaul
52d0: 74 20 76 61 6c 75 65 2c 20 6f 72 20 77 69 74 68  t value, or with
52e0: 20 4e 55 4c 4c 20 69 66 20 6e 6f 74 0a 64 65 66   NULL if not.def
52f0: 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 73 70  ault value is sp
5300: 65 63 69 66 69 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c  ecified..</p>..<
5310: 70 3e 54 68 65 20 73 65 63 6f 6e 64 20 66 6f 72  p>The second for
5320: 6d 20 6f 66 20 74 68 65 20 49 4e 53 45 52 54 20  m of the INSERT 
5330: 73 74 61 74 65 6d 65 6e 74 20 74 61 6b 65 73 20  statement takes 
5340: 69 74 20 64 61 74 61 20 66 72 6f 6d 20 61 0a 53  it data from a.S
5350: 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e  ELECT statement.
5360: 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20    The number of 
5370: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72  columns in the r
5380: 65 73 75 6c 74 20 6f 66 20 74 68 65 0a 53 45 4c  esult of the.SEL
5390: 45 43 54 20 6d 75 73 74 20 65 78 61 63 74 6c 79  ECT must exactly
53a0: 20 6d 61 74 63 68 20 74 68 65 20 6e 75 6d 62 65   match the numbe
53b0: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20  r of columns in 
53c0: 74 68 65 20 74 61 62 6c 65 20 69 66 0a 6e 6f 20  the table if.no 
53d0: 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 69 73 20 73  column list is s
53e0: 70 65 63 69 66 69 65 64 2c 20 6f 72 20 69 74 20  pecified, or it 
53f0: 6d 75 73 74 20 6d 61 74 63 68 20 74 68 65 20 6e  must match the n
5400: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
5410: 0a 6e 61 6d 65 20 69 6e 20 74 68 65 20 63 6f 6c  .name in the col
5420: 75 6d 6e 20 6c 69 73 74 2e 20 20 41 20 6e 65 77  umn list.  A new
5430: 20 65 6e 74 72 79 20 69 73 20 6d 61 64 65 20 69   entry is made i
5440: 6e 20 74 68 65 20 74 61 62 6c 65 0a 66 6f 72 20  n the table.for 
5450: 65 76 65 72 79 20 72 6f 77 20 6f 66 20 74 68 65  every row of the
5460: 20 53 45 4c 45 43 54 20 72 65 73 75 6c 74 2e 20   SELECT result. 
5470: 20 54 68 65 20 53 45 4c 45 43 54 20 6d 61 79 20   The SELECT may 
5480: 62 65 20 73 69 6d 70 6c 65 0a 6f 72 20 63 6f 6d  be simple.or com
5490: 70 6f 75 6e 64 2e 20 20 49 66 20 74 68 65 20 53  pound.  If the S
54a0: 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20  ELECT statement 
54b0: 68 61 73 20 61 6e 20 4f 52 44 45 52 20 42 59 20  has an ORDER BY 
54c0: 63 6c 61 75 73 65 2c 0a 74 68 65 20 4f 52 44 45  clause,.the ORDE
54d0: 52 20 42 59 20 69 73 20 69 67 6e 6f 72 65 64 2e  R BY is ignored.
54e0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74  </p>..<p>The opt
54f0: 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63  ional conflict-c
5500: 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20 74 68 65  lause allows the
5510: 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 6f   specification o
5520: 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65  f an alternative
5530: 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66  .constraint conf
5540: 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20  lict resolution 
5550: 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 75 73 65  algorithm to use
5560: 20 64 75 72 69 6e 67 20 74 68 69 73 20 6f 6e 65   during this one
5570: 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20 74 68   command..See th
5580: 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c 65 64  e section titled
5590: 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c  .<a href="#confl
55a0: 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54  ict">ON CONFLICT
55b0: 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74 69 6f  </a> for additio
55c0: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e  nal information.
55d0: 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20  </p>.}..Section 
55e0: 53 45 4c 45 43 54 20 73 65 6c 65 63 74 0a 0a 53  SELECT select..S
55f0: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
5600: 6d 65 6e 74 7d 20 7b 0a 53 45 4c 45 43 54 20 3c  ment} {.SELECT <
5610: 72 65 73 75 6c 74 3e 20 46 52 4f 4d 20 3c 74 61  result> FROM <ta
5620: 62 6c 65 2d 6c 69 73 74 3e 20 0a 5b 57 48 45 52  ble-list> .[WHER
5630: 45 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d 0a  E <expression>].
5640: 5b 47 52 4f 55 50 20 42 59 20 3c 65 78 70 72 2d  [GROUP BY <expr-
5650: 6c 69 73 74 3e 5d 0a 5b 48 41 56 49 4e 47 20 3c  list>].[HAVING <
5660: 65 78 70 72 65 73 73 69 6f 6e 3e 5d 0a 5b 3c 63  expression>].[<c
5670: 6f 6d 70 6f 75 6e 64 2d 6f 70 3e 20 3c 73 65 6c  ompound-op> <sel
5680: 65 63 74 3e 5d 2a 0a 5b 4f 52 44 45 52 20 42 59  ect>]*.[ORDER BY
5690: 20 3c 73 6f 72 74 2d 65 78 70 72 2d 6c 69 73 74   <sort-expr-list
56a0: 3e 5d 0a 5b 4c 49 4d 49 54 20 3c 69 6e 74 65 67  >].[LIMIT <integ
56b0: 65 72 3e 20 5b 4f 46 46 53 45 54 20 3c 69 6e 74  er> [OFFSET <int
56c0: 65 67 65 72 3e 5d 5d 0a 7d 20 7b 72 65 73 75 6c  eger>]].} {resul
56d0: 74 7d 20 7b 0a 53 54 41 52 20 7c 20 3c 72 65 73  t} {.STAR | <res
56e0: 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 20 5b 2c 20 3c  ult-column> [, <
56f0: 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 5d 2a  result-column>]*
5700: 0a 7d 20 7b 72 65 73 75 6c 74 2d 63 6f 6c 75 6d  .} {result-colum
5710: 6e 7d 20 7b 0a 3c 65 78 70 72 65 73 73 69 6f 6e  n} {.<expression
5720: 3e 20 5b 20 5b 41 53 5d 20 3c 73 74 72 69 6e 67  > [ [AS] <string
5730: 3e 20 5d 0a 7d 20 7b 74 61 62 6c 65 2d 6c 69 73  > ].} {table-lis
5740: 74 7d 20 7b 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65  t} {.<table-name
5750: 3e 20 5b 2c 20 3c 74 61 62 6c 65 2d 6e 61 6d 65  > [, <table-name
5760: 3e 5d 2a 0a 7d 20 7b 73 6f 72 74 2d 65 78 70 72  >]*.} {sort-expr
5770: 2d 6c 69 73 74 7d 20 7b 0a 3c 65 78 70 72 3e 20  -list} {.<expr> 
5780: 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20 5b  [<sort-order>] [
5790: 2c 20 3c 65 78 70 72 3e 20 5b 3c 73 6f 72 74 2d  , <expr> [<sort-
57a0: 6f 72 64 65 72 3e 5d 5d 2a 0a 7d 20 7b 73 6f 72  order>]]*.} {sor
57b0: 74 2d 6f 72 64 65 72 7d 20 7b 0a 41 53 43 20 7c  t-order} {.ASC |
57c0: 20 44 45 53 43 0a 7d 20 7b 63 6f 6d 70 6f 75 6e   DESC.} {compoun
57d0: 64 5f 6f 70 7d 20 7b 0a 55 4e 49 4f 4e 20 7c 20  d_op} {.UNION | 
57e0: 55 4e 49 4f 4e 20 41 4c 4c 20 7c 20 49 4e 54 45  UNION ALL | INTE
57f0: 52 53 45 43 54 20 7c 20 45 58 43 45 50 54 0a 7d  RSECT | EXCEPT.}
5800: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
5810: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74  SELECT statement
5820: 20 69 73 20 75 73 65 64 20 74 6f 20 71 75 65 72   is used to quer
5830: 79 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  y the database. 
5840: 20 54 68 65 0a 72 65 73 75 6c 74 20 6f 66 20 61   The.result of a
5850: 20 53 45 4c 45 43 54 20 69 73 20 7a 65 72 6f 20   SELECT is zero 
5860: 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66 20  or more rows of 
5870: 64 61 74 61 20 77 68 65 72 65 20 65 61 63 68 20  data where each 
5880: 72 6f 77 0a 68 61 73 20 61 20 66 69 78 65 64 20  row.has a fixed 
5890: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
58a0: 73 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f  s.  The number o
58b0: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65  f columns in the
58c0: 0a 72 65 73 75 6c 74 20 69 73 20 73 70 65 63 69  .result is speci
58d0: 66 69 65 64 20 62 79 20 74 68 65 20 65 78 70 72  fied by the expr
58e0: 65 73 73 69 6f 6e 20 6c 69 73 74 20 69 6e 20 62  ession list in b
58f0: 65 74 77 65 65 6e 20 74 68 65 0a 53 45 4c 45 43  etween the.SELEC
5900: 54 20 61 6e 64 20 46 52 4f 4d 20 6b 65 79 77 6f  T and FROM keywo
5910: 72 64 73 2e 20 20 41 6e 79 20 61 72 62 69 74 72  rds.  Any arbitr
5920: 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e 20 63  ary expression c
5930: 61 6e 20 62 65 20 75 73 65 64 0a 61 73 20 61 20  an be used.as a 
5940: 72 65 73 75 6c 74 2e 20 20 49 66 20 74 68 65 20  result.  If the 
5950: 72 65 73 75 6c 74 20 73 70 65 63 69 66 69 63 61  result specifica
5960: 74 69 6f 6e 20 69 73 20 6a 75 73 74 7d 0a 70 75  tion is just}.pu
5970: 74 73 20 22 5b 4f 70 65 72 61 74 6f 72 20 2a 5d  ts "[Operator *]
5980: 20 74 68 65 6e 20 61 6c 6c 20 63 6f 6c 75 6d 6e   then all column
5990: 73 20 6f 66 20 61 6c 6c 20 74 61 62 6c 65 73 20  s of all tables 
59a0: 61 72 65 20 75 73 65 64 20 61 73 20 74 68 65 20  are used as the 
59b0: 72 65 73 75 6c 74 2e 22 0a 70 75 74 73 20 7b 3c  result.".puts {<
59c0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 71 75 65 72  /p>..<p>The quer
59d0: 79 20 69 73 20 65 78 65 63 75 74 65 64 20 61 67  y is executed ag
59e0: 61 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20  ain one or more 
59f0: 74 61 62 6c 65 73 20 73 70 65 63 69 66 69 65 64  tables specified
5a00: 20 61 66 74 65 72 0a 74 68 65 20 46 52 4f 4d 20   after.the FROM 
5a10: 6b 65 79 77 6f 72 64 2e 20 20 49 66 20 6d 6f 72  keyword.  If mor
5a20: 65 20 74 68 61 6e 20 6f 6e 65 20 74 61 62 6c 65  e than one table
5a30: 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 74   is specified, t
5a40: 68 65 6e 20 74 68 65 0a 71 75 65 72 79 20 69 73  hen the.query is
5a50: 20 61 67 61 69 6e 73 74 20 74 68 65 20 6a 6f 69   against the joi
5a60: 6e 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73  n of the various
5a70: 20 74 61 62 6c 65 73 2e 3c 2f 70 3e 0a 0a 3c 70   tables.</p>..<p
5a80: 3e 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73  >The WHERE claus
5a90: 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  e can be used to
5aa0: 20 6c 69 6d 69 74 20 74 68 65 20 6e 75 6d 62 65   limit the numbe
5ab0: 72 20 6f 66 20 72 6f 77 73 20 6f 76 65 72 0a 77  r of rows over.w
5ac0: 68 69 63 68 20 74 68 65 20 71 75 65 72 79 20 6f  hich the query o
5ad0: 70 65 72 61 74 65 73 2e 20 20 49 6e 20 74 68 65  perates.  In the
5ae0: 20 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65   current impleme
5af0: 6e 74 61 74 69 6f 6e 2c 0a 69 6e 64 69 63 65 73  ntation,.indices
5b00: 20 77 69 6c 6c 20 6f 6e 6c 79 20 62 65 20 75 73   will only be us
5b10: 65 64 20 74 6f 0a 6f 70 74 69 6d 69 7a 65 20 74  ed to.optimize t
5b20: 68 65 20 71 75 65 72 79 20 69 66 20 57 48 45 52  he query if WHER
5b30: 45 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 6e  E expression con
5b40: 74 61 69 6e 73 20 65 71 75 61 6c 69 74 79 20 63  tains equality c
5b50: 6f 6d 70 61 72 69 73 6f 6e 73 0a 63 6f 6e 6e 65  omparisons.conne
5b60: 63 74 65 64 20 62 79 20 74 68 65 20 41 4e 44 20  cted by the AND 
5b70: 6f 70 65 72 61 74 6f 72 2e 3c 2f 70 3e 0a 0a 3c  operator.</p>..<
5b80: 70 3e 54 68 65 20 47 52 4f 55 50 20 42 59 20 63  p>The GROUP BY c
5b90: 6c 61 75 73 65 73 20 63 61 75 73 65 73 20 6f 6e  lauses causes on
5ba0: 65 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f  e or more rows o
5bb0: 66 20 74 68 65 20 72 65 73 75 6c 74 20 74 6f 0a  f the result to.
5bc0: 62 65 20 63 6f 6d 62 69 6e 65 64 20 69 6e 74 6f  be combined into
5bd0: 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f 66   a single row of
5be0: 20 6f 75 74 70 75 74 2e 20 20 54 68 69 73 20 69   output.  This i
5bf0: 73 20 65 73 70 65 63 69 61 6c 6c 79 20 75 73 65  s especially use
5c00: 66 75 6c 0a 77 68 65 6e 20 74 68 65 20 72 65 73  ful.when the res
5c10: 75 6c 74 20 63 6f 6e 74 61 69 6e 73 20 61 67 67  ult contains agg
5c20: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73  regate functions
5c30: 2e 20 20 54 68 65 20 65 78 70 72 65 73 73 69 6f  .  The expressio
5c40: 6e 73 20 69 6e 0a 74 68 65 20 47 52 4f 55 50 20  ns in.the GROUP 
5c50: 42 59 20 63 6c 61 75 73 65 20 64 6f 20 3c 65 6d  BY clause do <em
5c60: 3e 6e 6f 74 3c 2f 65 6d 3e 20 68 61 76 65 20 74  >not</em> have t
5c70: 6f 20 62 65 20 65 78 70 72 65 73 73 69 6f 6e 73  o be expressions
5c80: 20 74 68 61 74 0a 61 70 70 65 61 72 20 69 6e 20   that.appear in 
5c90: 74 68 65 20 72 65 73 75 6c 74 2e 20 20 54 68 65  the result.  The
5ca0: 20 48 41 56 49 4e 47 20 63 6c 61 75 73 65 20 69   HAVING clause i
5cb0: 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 57 48 45  s similar to WHE
5cc0: 52 45 20 65 78 63 65 70 74 0a 74 68 61 74 20 48  RE except.that H
5cd0: 41 56 49 4e 47 20 61 70 70 6c 69 65 73 20 61 66  AVING applies af
5ce0: 74 65 72 20 67 72 6f 75 70 69 6e 67 20 68 61 73  ter grouping has
5cf0: 20 6f 63 63 75 72 72 65 64 2e 20 20 54 68 65 20   occurred.  The 
5d00: 48 41 56 49 4e 47 20 65 78 70 72 65 73 73 69 6f  HAVING expressio
5d10: 6e 0a 6d 61 79 20 72 65 66 65 72 20 74 6f 20 76  n.may refer to v
5d20: 61 6c 75 65 73 2c 20 65 76 65 6e 20 61 67 67 72  alues, even aggr
5d30: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2c  egate functions,
5d40: 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 69 6e   that are not in
5d50: 20 74 68 65 20 72 65 73 75 6c 74 2e 3c 2f 70 3e   the result.</p>
5d60: 0a 0a 3c 70 3e 54 68 65 20 4f 52 44 45 52 20 42  ..<p>The ORDER B
5d70: 59 20 63 6c 61 75 73 65 20 63 61 75 73 65 73 20  Y clause causes 
5d80: 74 68 65 20 6f 75 74 70 75 74 20 72 6f 77 73 20  the output rows 
5d90: 74 6f 20 62 65 20 73 6f 72 74 65 64 2e 20 20 0a  to be sorted.  .
5da0: 54 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  The argument to 
5db0: 4f 52 44 45 52 20 42 59 20 69 73 20 61 20 6c 69  ORDER BY is a li
5dc0: 73 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e  st of expression
5dd0: 73 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20  s that are used 
5de0: 61 73 20 74 68 65 0a 6b 65 79 20 66 6f 72 20 74  as the.key for t
5df0: 68 65 20 73 6f 72 74 2e 20 20 54 68 65 20 65 78  he sort.  The ex
5e00: 70 72 65 73 73 69 6f 6e 73 20 64 6f 20 6e 6f 74  pressions do not
5e10: 20 68 61 76 65 20 74 6f 20 62 65 20 70 61 72 74   have to be part
5e20: 20 6f 66 20 74 68 65 0a 72 65 73 75 6c 74 20 66   of the.result f
5e30: 6f 72 20 61 20 73 69 6d 70 6c 65 20 53 45 4c 45  or a simple SELE
5e40: 43 54 2c 20 62 75 74 20 69 6e 20 61 20 63 6f 6d  CT, but in a com
5e50: 70 6f 75 6e 64 20 53 45 4c 45 43 54 20 65 61 63  pound SELECT eac
5e60: 68 20 73 6f 72 74 0a 65 78 70 72 65 73 73 69 6f  h sort.expressio
5e70: 6e 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d  n must exactly m
5e80: 61 74 63 68 20 6f 6e 65 20 6f 66 20 74 68 65 20  atch one of the 
5e90: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20  result columns. 
5ea0: 20 45 61 63 68 0a 73 6f 72 74 20 65 78 70 72 65   Each.sort expre
5eb0: 73 73 69 6f 6e 20 6d 61 79 20 62 65 20 6f 70 74  ssion may be opt
5ec0: 69 6f 6e 61 6c 6c 79 20 66 6f 6c 6c 6f 77 65 64  ionally followed
5ed0: 20 62 79 20 41 53 43 20 6f 72 20 44 45 53 43 20   by ASC or DESC 
5ee0: 74 6f 20 73 70 65 63 69 66 79 0a 74 68 65 20 73  to specify.the s
5ef0: 6f 72 74 20 6f 72 64 65 72 2e 3c 2f 70 3e 0a 0a  ort order.</p>..
5f00: 3c 70 3e 54 68 65 20 4c 49 4d 49 54 20 63 6c 61  <p>The LIMIT cla
5f10: 75 73 65 20 70 6c 61 63 65 73 20 61 6e 20 75 70  use places an up
5f20: 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65  per bound on the
5f30: 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 0a   number of rows.
5f40: 72 65 74 75 72 6e 65 64 20 69 6e 20 74 68 65 20  returned in the 
5f50: 72 65 73 75 6c 74 2e 20 20 41 20 4c 49 4d 49 54  result.  A LIMIT
5f60: 20 6f 66 20 30 20 69 6e 64 69 63 61 74 65 73 20   of 0 indicates 
5f70: 6e 6f 20 75 70 70 65 72 20 62 6f 75 6e 64 2e 0a  no upper bound..
5f80: 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 4f 46 46  The optional OFF
5f90: 53 45 54 20 66 6f 6c 6c 6f 77 69 6e 67 20 4c 49  SET following LI
5fa0: 4d 49 54 20 73 70 65 63 69 66 69 65 73 20 68 6f  MIT specifies ho
5fb0: 77 20 6d 61 6e 79 0a 72 6f 77 73 20 74 6f 20 73  w many.rows to s
5fc0: 6b 69 70 20 61 74 20 74 68 65 20 62 65 67 69 6e  kip at the begin
5fd0: 6e 69 6e 67 20 6f 66 20 74 68 65 20 72 65 73 75  ning of the resu
5fe0: 6c 74 20 73 65 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e  lt set.</p>..<p>
5ff0: 41 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43  A compound SELEC
6000: 54 20 69 73 20 66 6f 72 6d 65 64 20 66 72 6f 6d  T is formed from
6010: 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 73 69 6d   two or more sim
6020: 70 6c 65 20 53 45 4c 45 43 54 73 20 63 6f 6e 6e  ple SELECTs conn
6030: 65 63 74 65 64 0a 62 79 20 6f 6e 65 20 6f 66 20  ected.by one of 
6040: 74 68 65 20 6f 70 65 72 61 74 6f 72 73 20 55 4e  the operators UN
6050: 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c 2c 20  ION, UNION ALL, 
6060: 49 4e 54 45 52 53 45 43 54 2c 20 6f 72 20 45 58  INTERSECT, or EX
6070: 43 45 50 54 2e 20 20 49 6e 0a 61 20 63 6f 6d 70  CEPT.  In.a comp
6080: 6f 75 6e 64 20 53 45 4c 45 43 54 2c 20 61 6c 6c  ound SELECT, all
6090: 20 74 68 65 20 63 6f 6e 73 74 69 74 75 65 6e 74   the constituent
60a0: 20 53 45 4c 45 43 54 73 20 6d 75 73 74 20 73 70   SELECTs must sp
60b0: 65 63 69 66 79 20 74 68 65 0a 73 61 6d 65 20 6e  ecify the.same n
60c0: 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20  umber of result 
60d0: 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 72 65 20  columns.  There 
60e0: 6d 61 79 20 62 65 20 6f 6e 6c 79 20 61 20 73 69  may be only a si
60f0: 6e 67 6c 65 20 4f 52 44 45 52 20 42 59 0a 63 6c  ngle ORDER BY.cl
6100: 61 75 73 65 20 61 74 20 74 68 65 20 65 6e 64 20  ause at the end 
6110: 6f 66 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20  of the compound 
6120: 53 45 4c 45 43 54 2e 20 20 54 68 65 20 55 4e 49  SELECT.  The UNI
6130: 4f 4e 20 61 6e 64 20 55 4e 49 4f 4e 20 41 4c 4c  ON and UNION ALL
6140: 0a 6f 70 65 72 61 74 6f 72 73 20 63 6f 6d 62 69  .operators combi
6150: 6e 65 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f  ne the results o
6160: 66 20 74 68 65 20 53 45 4c 45 43 54 73 20 74 6f  f the SELECTs to
6170: 20 74 68 65 20 72 69 67 68 74 20 61 6e 64 20 6c   the right and l
6180: 65 66 74 20 69 6e 74 6f 0a 61 20 73 69 6e 67 6c  eft into.a singl
6190: 65 20 62 69 67 20 74 61 62 6c 65 2e 20 20 54 68  e big table.  Th
61a0: 65 20 64 69 66 66 65 72 65 6e 63 65 20 69 73 20  e difference is 
61b0: 74 68 61 74 20 69 6e 20 55 4e 49 4f 4e 20 61 6c  that in UNION al
61c0: 6c 20 72 65 73 75 6c 74 20 72 6f 77 73 0a 61 72  l result rows.ar
61d0: 65 20 64 69 73 74 69 6e 63 74 20 77 68 65 72 65  e distinct where
61e0: 20 69 6e 20 55 4e 49 4f 4e 20 41 4c 4c 20 74 68   in UNION ALL th
61f0: 65 72 65 20 6d 61 79 20 62 65 20 64 75 70 6c 69  ere may be dupli
6200: 63 61 74 65 73 2e 0a 54 68 65 20 49 4e 54 45 52  cates..The INTER
6210: 53 45 43 54 20 6f 70 65 72 61 74 6f 72 20 74 61  SECT operator ta
6220: 6b 65 73 20 74 68 65 20 69 6e 74 65 72 73 65 63  kes the intersec
6230: 74 69 6f 6e 20 6f 66 20 74 68 65 20 72 65 73 75  tion of the resu
6240: 6c 74 73 20 6f 66 20 74 68 65 0a 6c 65 66 74 20  lts of the.left 
6250: 61 6e 64 20 72 69 67 68 74 20 53 45 4c 45 43 54  and right SELECT
6260: 73 2e 20 20 45 58 43 45 50 54 20 74 61 6b 65 73  s.  EXCEPT takes
6270: 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 6c   the result of l
6280: 65 66 74 20 53 45 4c 45 43 54 20 61 66 74 65 72  eft SELECT after
6290: 0a 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 72 65  .removing the re
62a0: 73 75 6c 74 73 20 6f 66 20 74 68 65 20 72 69 67  sults of the rig
62b0: 68 74 20 53 45 4c 45 43 54 2e 20 20 57 68 65 6e  ht SELECT.  When
62c0: 20 74 68 72 65 65 20 61 72 65 20 6d 6f 72 65 20   three are more 
62d0: 53 45 4c 45 43 54 73 0a 61 72 65 20 63 6f 6e 6e  SELECTs.are conn
62e0: 65 63 74 65 64 20 69 6e 74 6f 20 61 20 63 6f 6d  ected into a com
62f0: 70 6f 75 6e 64 2c 20 74 68 65 79 20 67 72 6f 75  pound, they grou
6300: 70 20 66 72 6f 6d 20 6c 65 66 74 20 74 6f 20 72  p from left to r
6310: 69 67 68 74 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63  ight.</p>.}..Sec
6320: 74 69 6f 6e 20 55 50 44 41 54 45 20 75 70 64 61  tion UPDATE upda
6330: 74 65 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  te..Syntax {sql-
6340: 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 55 50 44  statement} {.UPD
6350: 41 54 45 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d  ATE [ <conflict-
6360: 63 6c 61 75 73 65 3e 20 5d 20 3c 74 61 62 6c 65  clause> ] <table
6370: 2d 6e 61 6d 65 3e 0a 53 45 54 20 3c 61 73 73 69  -name>.SET <assi
6380: 67 6e 6d 65 6e 74 3e 20 5b 2c 20 3c 61 73 73 69  gnment> [, <assi
6390: 67 6e 6d 65 6e 74 3e 5d 20 0a 5b 57 48 45 52 45  gnment>] .[WHERE
63a0: 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d 0a 7d   <expression>].}
63b0: 20 7b 61 73 73 69 67 6e 6d 65 6e 74 7d 20 7b 0a   {assignment} {.
63c0: 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 3d 20  <column-name> = 
63d0: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 0a 7d 0a 0a  <expression>.}..
63e0: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 55 50  puts {.<p>The UP
63f0: 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20 69  DATE statement i
6400: 73 20 75 73 65 64 20 74 6f 20 63 68 61 6e 67 65  s used to change
6410: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 63 6f   the value of co
6420: 6c 75 6d 6e 73 20 69 6e 20 0a 73 65 6c 65 63 74  lumns in .select
6430: 65 64 20 72 6f 77 73 20 6f 66 20 61 20 74 61 62  ed rows of a tab
6440: 6c 65 2e 20 20 45 61 63 68 20 61 73 73 69 67 6e  le.  Each assign
6450: 6d 65 6e 74 20 69 6e 20 61 6e 20 55 50 44 41 54  ment in an UPDAT
6460: 45 20 73 70 65 63 69 66 69 65 73 0a 61 20 63 6f  E specifies.a co
6470: 6c 75 6d 6e 20 6e 61 6d 65 20 74 6f 20 74 68 65  lumn name to the
6480: 20 6c 65 66 74 20 6f 66 20 74 68 65 20 65 71 75   left of the equ
6490: 61 6c 73 20 73 69 67 6e 20 61 6e 64 20 61 6e 20  als sign and an 
64a0: 61 72 62 69 74 72 61 72 79 20 65 78 70 72 65 73  arbitrary expres
64b0: 73 69 6f 6e 0a 74 6f 20 74 68 65 20 72 69 67 68  sion.to the righ
64c0: 74 2e 20 20 54 68 65 20 65 78 70 72 65 73 73 69  t.  The expressi
64d0: 6f 6e 73 20 6d 61 79 20 75 73 65 20 74 68 65 20  ons may use the 
64e0: 76 61 6c 75 65 73 20 6f 66 20 6f 74 68 65 72 20  values of other 
64f0: 63 6f 6c 75 6d 6e 73 2e 0a 41 6c 6c 20 65 78 70  columns..All exp
6500: 72 65 73 73 69 6f 6e 73 20 61 72 65 20 65 76 61  ressions are eva
6510: 6c 75 61 74 65 64 20 62 65 66 6f 72 65 20 61 6e  luated before an
6520: 79 20 61 73 73 69 67 6e 6d 65 6e 74 73 20 61 72  y assignments ar
6530: 65 20 6d 61 64 65 2e 0a 41 20 57 48 45 52 45 20  e made..A WHERE 
6540: 63 6c 61 75 73 65 20 63 61 6e 20 62 65 20 75 73  clause can be us
6550: 65 64 20 74 6f 20 72 65 73 74 72 69 63 74 20 77  ed to restrict w
6560: 68 69 63 68 20 72 6f 77 73 20 61 72 65 20 75 70  hich rows are up
6570: 64 61 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  dated.</p>..<p>T
6580: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66  he optional conf
6590: 6c 69 63 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f  lict-clause allo
65a0: 77 73 20 74 68 65 20 73 70 65 63 69 66 69 63 61  ws the specifica
65b0: 74 69 6f 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72  tion of an alter
65c0: 6e 61 74 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e  native.constrain
65d0: 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c  t conflict resol
65e0: 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20  ution algorithm 
65f0: 74 6f 20 75 73 65 20 64 75 72 69 6e 67 20 74 68  to use during th
6600: 69 73 20 6f 6e 65 20 63 6f 6d 6d 61 6e 64 2e 0a  is one command..
6610: 53 65 65 20 74 68 65 20 73 65 63 74 69 6f 6e 20  See the section 
6620: 74 69 74 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22  titled.<a href="
6630: 23 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f  #conflict">ON CO
6640: 4e 46 4c 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61  NFLICT</a> for a
6650: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d  dditional inform
6660: 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65  ation.</p>.}..Se
6670: 63 74 69 6f 6e 20 56 41 43 55 55 4d 20 76 61 63  ction VACUUM vac
6680: 75 75 6d 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  uum..Syntax {sql
6690: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 56 41  -statement} {.VA
66a0: 43 55 55 4d 20 5b 3c 69 6e 64 65 78 2d 6f 72 2d  CUUM [<index-or-
66b0: 74 61 62 6c 65 2d 6e 61 6d 65 3e 5d 0a 7d 0a 0a  table-name>].}..
66c0: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 56 41  puts {.<p>The VA
66d0: 43 55 55 4d 20 63 6f 6d 6d 61 6e 64 20 69 73 20  CUUM command is 
66e0: 61 6e 20 53 51 4c 69 74 65 20 65 78 74 65 6e 73  an SQLite extens
66f0: 69 6f 6e 20 6d 6f 64 65 6c 6c 65 64 20 61 66 74  ion modelled aft
6700: 65 72 20 61 20 73 69 6d 69 6c 61 72 0a 63 6f 6d  er a similar.com
6710: 6d 61 6e 64 20 66 6f 75 6e 64 20 69 6e 20 50 6f  mand found in Po
6720: 73 74 67 72 65 53 51 4c 2e 20 20 49 66 20 56 41  stgreSQL.  If VA
6730: 43 55 55 4d 20 69 73 20 69 6e 76 6f 6b 65 64 20  CUUM is invoked 
6740: 77 69 74 68 20 74 68 65 20 6e 61 6d 65 20 6f 66  with the name of
6750: 20 61 0a 74 61 62 6c 65 20 6f 72 20 69 6e 64 65   a.table or inde
6760: 78 20 74 68 65 6e 20 69 74 20 69 73 20 73 75 70  x then it is sup
6770: 70 6f 73 65 20 74 6f 20 63 6c 65 61 6e 20 75 70  pose to clean up
6780: 20 74 68 65 20 6e 61 6d 65 64 20 74 61 62 6c 65   the named table
6790: 20 6f 72 20 69 6e 64 65 78 2e 0a 49 6e 20 76 65   or index..In ve
67a0: 72 73 69 6f 6e 20 31 2e 30 20 6f 66 20 53 51 4c  rsion 1.0 of SQL
67b0: 69 74 65 2c 20 74 68 65 20 56 41 43 55 55 4d 20  ite, the VACUUM 
67c0: 63 6f 6d 6d 61 6e 64 20 77 6f 75 6c 64 20 69 6e  command would in
67d0: 76 6f 6b 65 20 0a 3c 62 3e 67 64 62 6d 5f 72 65  voke .<b>gdbm_re
67e0: 6f 72 67 61 6e 69 7a 65 28 29 3c 2f 62 3e 20 74  organize()</b> t
67f0: 6f 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20 62  o clean up the b
6800: 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65 20  ackend database 
6810: 66 69 6c 65 2e 0a 42 65 67 69 6e 6e 69 6e 67 20  file..Beginning 
6820: 77 69 74 68 20 76 65 72 73 69 6f 6e 20 32 2e 30  with version 2.0
6830: 20 6f 66 20 53 51 4c 69 74 65 2c 20 47 44 42 4d   of SQLite, GDBM
6840: 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 73   is no longer us
6850: 65 64 20 66 6f 72 0a 74 68 65 20 64 61 74 61 62  ed for.the datab
6860: 61 73 65 20 62 61 63 6b 65 6e 64 20 61 6e 64 20  ase backend and 
6870: 56 41 43 55 55 4d 20 68 61 73 20 62 65 63 6f 6d  VACUUM has becom
6880: 65 20 61 20 6e 6f 2d 6f 70 2e 0a 3c 2f 70 3e 0a  e a no-op..</p>.
6890: 7d 0a 0a 53 65 63 74 69 6f 6e 20 50 52 41 47 4d  }..Section PRAGM
68a0: 41 20 70 72 61 67 6d 61 0a 0a 53 79 6e 74 61 78  A pragma..Syntax
68b0: 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d   {sql-statement}
68c0: 20 7b 0a 50 52 41 47 4d 41 20 3c 6e 61 6d 65 3e   {.PRAGMA <name>
68d0: 20 3d 20 3c 76 61 6c 75 65 3e 20 7c 0a 50 52 41   = <value> |.PRA
68e0: 47 4d 41 20 3c 66 75 6e 63 74 69 6f 6e 3e 28 3c  GMA <function>(<
68f0: 61 72 67 3e 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a  arg>).}..puts {.
6900: 3c 70 3e 54 68 65 20 50 52 41 47 4d 41 20 63 6f  <p>The PRAGMA co
6910: 6d 6d 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f  mmand is used to
6920: 20 6d 6f 64 69 66 79 20 74 68 65 20 6f 70 65 72   modify the oper
6930: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 53 51 4c  ation of the SQL
6940: 69 74 65 20 6c 69 62 72 61 72 79 2e 0a 54 68 65  ite library..The
6950: 20 70 72 61 67 6d 61 20 63 6f 6d 6d 61 6e 64 20   pragma command 
6960: 69 73 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 20  is experimental 
6970: 61 6e 64 20 73 70 65 63 69 66 69 63 20 70 72 61  and specific pra
6980: 67 6d 61 20 73 74 61 74 65 6d 65 6e 74 73 20 6d  gma statements m
6990: 61 79 0a 72 65 6d 6f 76 65 64 20 6f 72 20 61 64  ay.removed or ad
69a0: 64 65 64 20 69 6e 20 66 75 74 75 72 65 20 72 65  ded in future re
69b0: 6c 65 61 73 65 73 20 6f 66 20 53 51 4c 69 74 65  leases of SQLite
69c0: 2e 20 20 55 73 65 20 74 68 69 73 20 63 6f 6d 6d  .  Use this comm
69d0: 61 6e 64 0a 77 69 74 68 20 63 61 75 74 69 6f 6e  and.with caution
69e0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 75  .</p>..<p>The cu
69f0: 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61  rrent implementa
6a00: 74 69 6f 6e 20 73 75 70 70 6f 72 74 73 20 74 68  tion supports th
6a10: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 61 67  e following prag
6a20: 6d 61 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c  mas:</p>..<ul>.<
6a30: 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20  li><p><b>PRAGMA 
6a40: 63 61 63 68 65 5f 73 69 7a 65 20 3d 20 3c 2f 62  cache_size = </b
6a50: 3e 3c 69 3e 4e 75 6d 62 65 72 2d 6f 66 2d 70 61  ><i>Number-of-pa
6a60: 67 65 73 3c 2f 69 3e 3c 62 3e 3b 3c 2f 62 3e 3c  ges</i><b>;</b><
6a70: 2f 70 3e 0a 20 20 20 20 3c 70 3e 43 68 61 6e 67  /p>.    <p>Chang
6a80: 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75  e the maximum nu
6a90: 6d 62 65 72 20 6f 66 20 64 61 74 61 62 61 73 65  mber of database
6aa0: 20 64 69 73 6b 20 70 61 67 65 73 20 74 68 61 74   disk pages that
6ab0: 20 53 51 4c 69 74 65 0a 20 20 20 20 77 69 6c 6c   SQLite.    will
6ac0: 20 68 6f 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20   hold in memory 
6ad0: 61 74 20 6f 6e 63 65 2e 20 20 45 61 63 68 20 70  at once.  Each p
6ae0: 61 67 65 20 75 73 65 73 20 61 62 6f 75 74 20 31  age uses about 1
6af0: 2e 35 4b 20 6f 66 20 52 41 4d 2e 0a 20 20 20 20  .5K of RAM..    
6b00: 54 68 65 20 64 65 66 61 75 6c 74 20 63 61 63 68  The default cach
6b10: 65 20 73 69 7a 65 20 69 73 20 31 30 30 2e 20 20  e size is 100.  
6b20: 49 66 20 79 6f 75 20 61 72 65 20 64 6f 69 6e 67  If you are doing
6b30: 20 55 50 44 41 54 45 73 20 6f 72 20 44 45 4c 45   UPDATEs or DELE
6b40: 54 45 73 0a 20 20 20 20 74 68 61 74 20 63 68 61  TEs.    that cha
6b50: 6e 67 65 20 6d 61 6e 79 20 72 6f 77 73 20 6f 66  nge many rows of
6b60: 20 61 20 64 61 74 61 62 61 73 65 20 61 6e 64 20   a database and 
6b70: 79 6f 75 20 64 6f 20 6e 6f 74 20 6d 69 6e 64 20  you do not mind 
6b80: 69 66 20 53 51 4c 69 74 65 0a 20 20 20 20 75 73  if SQLite.    us
6b90: 65 73 20 6d 6f 72 65 20 6d 65 6d 6f 72 79 2c 20  es more memory, 
6ba0: 79 6f 75 20 63 61 6e 20 69 6e 63 72 65 61 73 65  you can increase
6bb0: 20 74 68 65 20 63 61 63 68 65 20 73 69 7a 65 20   the cache size 
6bc0: 66 6f 72 20 61 20 70 6f 73 73 69 62 6c 65 20 73  for a possible s
6bd0: 70 65 65 64 0a 20 20 20 20 69 6d 70 72 6f 76 65  peed.    improve
6be0: 6d 65 6e 74 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a  ment.</p></li>..
6bf0: 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41  <li><p><b>PRAGMA
6c00: 20 63 6f 75 6e 74 5f 63 68 61 6e 67 65 73 20 3d   count_changes =
6c10: 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e   ON;.       <br>
6c20: 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f 63 68 61  PRAGMA count_cha
6c30: 6e 67 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c  nges = OFF;</b><
6c40: 2f 70 3e 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20  /p>.    <p>When 
6c50: 6f 6e 2c 20 74 68 65 20 43 4f 55 4e 54 5f 43 48  on, the COUNT_CH
6c60: 41 4e 47 45 53 20 70 72 61 67 6d 61 20 63 61 75  ANGES pragma cau
6c70: 73 65 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b  ses the callback
6c80: 20 66 75 6e 63 74 69 6f 6e 20 74 6f 0a 20 20 20   function to.   
6c90: 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f 6e 63 65   be invoked once
6ca0: 20 66 6f 72 20 65 61 63 68 20 44 45 4c 45 54 45   for each DELETE
6cb0: 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44  , INSERT, or UPD
6cc0: 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20  ATE operation.  
6cd0: 54 68 65 0a 20 20 20 20 61 72 67 75 6d 65 6e 74  The.    argument
6ce0: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   is the number o
6cf0: 66 20 72 6f 77 73 20 74 68 61 74 20 77 65 72 65  f rows that were
6d00: 20 63 68 61 6e 67 65 64 2e 3c 2f 70 3e 0a 0a 3c   changed.</p>..<
6d10: 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20  li><p><b>PRAGMA 
6d20: 65 6d 70 74 79 5f 72 65 73 75 6c 74 5f 63 61 6c  empty_result_cal
6d30: 6c 62 61 63 6b 73 20 3d 20 4f 4e 3b 0a 20 20 20  lbacks = ON;.   
6d40: 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 65      <br>PRAGMA e
6d50: 6d 70 74 79 5f 72 65 73 75 6c 74 5f 63 61 6c 6c  mpty_result_call
6d60: 62 61 63 6b 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e  backs = OFF;</b>
6d70: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 57 68 65 6e  </p>.    <p>When
6d80: 20 6f 6e 2c 20 74 68 65 20 45 4d 50 54 59 5f 52   on, the EMPTY_R
6d90: 45 53 55 4c 54 5f 43 41 4c 4c 42 41 43 4b 53 20  ESULT_CALLBACKS 
6da0: 70 72 61 67 6d 61 20 63 61 75 73 65 73 20 74 68  pragma causes th
6db0: 65 20 63 61 6c 6c 62 61 63 6b 0a 20 20 20 20 66  e callback.    f
6dc0: 75 6e 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e  unction to be in
6dd0: 76 6f 6b 65 64 20 6f 6e 63 65 20 66 6f 72 20 65  voked once for e
6de0: 61 63 68 20 71 75 65 72 79 20 74 68 61 74 20 68  ach query that h
6df0: 61 73 20 61 6e 20 65 6d 70 74 79 20 72 65 73 75  as an empty resu
6e00: 6c 74 0a 20 20 20 20 73 65 74 2e 20 20 54 68 65  lt.    set.  The
6e10: 20 74 68 69 72 64 20 22 3c 62 3e 61 72 67 76 3c   third "<b>argv<
6e20: 2f 62 3e 22 20 70 61 72 61 6d 65 74 65 72 20 74  /b>" parameter t
6e30: 6f 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 69  o the callback i
6e40: 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 0a 20 20  s set to NULL.  
6e50: 20 20 62 65 63 61 75 73 65 20 74 68 65 72 65 20    because there 
6e60: 69 73 20 6e 6f 20 64 61 74 61 20 74 6f 20 72 65  is no data to re
6e70: 70 6f 72 74 2e 20 20 42 75 74 20 74 68 65 20 73  port.  But the s
6e80: 65 63 6f 6e 64 20 22 3c 62 3e 61 72 67 63 3c 2f  econd "<b>argc</
6e90: 62 3e 22 20 61 6e 64 0a 20 20 20 20 66 6f 75 72  b>" and.    four
6ea0: 74 68 20 22 3c 62 3e 63 6f 6c 75 6d 6e 4e 61 6d  th "<b>columnNam
6eb0: 65 73 3c 2f 62 3e 22 20 70 61 72 61 6d 65 74 65  es</b>" paramete
6ec0: 72 73 20 61 72 65 20 76 61 6c 69 64 20 61 6e 64  rs are valid and
6ed0: 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 0a   can be used to.
6ee0: 20 20 20 20 64 65 74 65 72 6d 69 6e 65 20 74 68      determine th
6ef0: 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 6e 61 6d  e number and nam
6f00: 65 73 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e  es of the column
6f10: 73 20 74 68 61 74 20 77 6f 75 6c 64 20 68 61 76  s that would hav
6f20: 65 20 62 65 65 6e 20 69 6e 0a 20 20 20 20 74 68  e been in.    th
6f30: 65 20 72 65 73 75 6c 74 20 73 65 74 20 68 61 64  e result set had
6f40: 20 74 68 65 20 73 65 74 20 6e 6f 74 20 62 65 65   the set not bee
6f50: 6e 20 65 6d 70 74 79 2e 3c 2f 70 3e 0a 0a 3c 6c  n empty.</p>..<l
6f60: 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 66  i><p><b>PRAGMA f
6f70: 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 73  ull_column_names
6f80: 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62   = ON;.       <b
6f90: 72 3e 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f  r>PRAGMA full_co
6fa0: 6c 75 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 46 46  lumn_names = OFF
6fb0: 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70  ;</b></p>.    <p
6fc0: 3e 54 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65  >The column name
6fd0: 73 20 72 65 70 6f 72 74 65 64 20 69 6e 20 61 6e  s reported in an
6fe0: 20 53 51 4c 69 74 65 20 63 61 6c 6c 62 61 63 6b   SQLite callback
6ff0: 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 6a 75   are normally ju
7000: 73 74 0a 20 20 20 20 74 68 65 20 6e 61 6d 65 20  st.    the name 
7010: 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 69 74  of the column it
7020: 73 65 6c 66 2c 20 65 78 63 65 70 74 20 66 6f 72  self, except for
7030: 20 6a 6f 69 6e 73 20 77 68 65 6e 20 22 54 41 42   joins when "TAB
7040: 4c 45 2e 43 4f 4c 55 4d 4e 22 0a 20 20 20 20 69  LE.COLUMN".    i
7050: 73 20 75 73 65 64 2e 20 20 42 75 74 20 77 68 65  s used.  But whe
7060: 6e 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61  n full_column_na
7070: 6d 65 73 20 69 73 20 74 75 72 6e 65 64 20 6f 6e  mes is turned on
7080: 2c 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 61  , column names a
7090: 72 65 0a 20 20 20 20 61 6c 77 61 79 73 20 72 65  re.    always re
70a0: 70 6f 72 74 65 64 20 61 73 20 22 54 41 42 4c 45  ported as "TABLE
70b0: 2e 43 4f 4c 55 4d 4e 22 20 65 76 65 6e 20 66 6f  .COLUMN" even fo
70c0: 72 20 73 69 6d 70 6c 65 20 71 75 65 72 69 65 73  r simple queries
70d0: 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e  .</p></li>..<li>
70e0: 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 69 6e 64  <p><b>PRAGMA ind
70f0: 65 78 5f 69 6e 66 6f 28 3c 2f 62 3e 3c 69 3e 69  ex_info(</b><i>i
7100: 6e 64 65 78 2d 6e 61 6d 65 3c 2f 69 3e 3c 62 3e  ndex-name</i><b>
7110: 29 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c  );</b></p>.    <
7120: 70 3e 46 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d  p>For each colum
7130: 6e 20 74 68 61 74 20 74 68 65 20 6e 61 6d 65 64  n that the named
7140: 20 69 6e 64 65 78 20 72 65 66 65 72 65 6e 63 65   index reference
7150: 73 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 0a 20  s, invoke the . 
7160: 20 20 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63     callback func
7170: 74 69 6f 6e 0a 20 20 20 20 6f 6e 63 65 20 77 69  tion.    once wi
7180: 74 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61  th information a
7190: 62 6f 75 74 20 74 68 61 74 20 63 6f 6c 75 6d 6e  bout that column
71a0: 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20  , including the 
71b0: 63 6f 6c 75 6d 6e 20 6e 61 6d 65 2c 0a 20 20 20  column name,.   
71c0: 20 61 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e 20   and the column 
71d0: 6e 75 6d 62 65 72 2e 3c 2f 70 3e 0a 0a 3c 6c 69  number.</p>..<li
71e0: 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 69 6e  ><p><b>PRAGMA in
71f0: 64 65 78 5f 6c 69 73 74 28 3c 2f 62 3e 3c 69 3e  dex_list(</b><i>
7200: 74 61 62 6c 65 2d 6e 61 6d 65 3c 2f 69 3e 3c 62  table-name</i><b
7210: 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20  >);</b></p>.    
7220: 3c 70 3e 46 6f 72 20 65 61 63 68 20 69 6e 64 65  <p>For each inde
7230: 78 20 6f 6e 20 74 68 65 20 6e 61 6d 65 64 20 74  x on the named t
7240: 61 62 6c 65 2c 20 69 6e 76 6f 6b 65 20 74 68 65  able, invoke the
7250: 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69   callback functi
7260: 6f 6e 0a 20 20 20 20 6f 6e 63 65 20 77 69 74 68  on.    once with
7270: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f   information abo
7280: 75 74 20 74 68 61 74 20 69 6e 64 65 78 2e 20 20  ut that index.  
7290: 41 72 67 75 6d 65 6e 74 73 20 69 6e 63 6c 75 64  Arguments includ
72a0: 65 20 74 68 65 0a 20 20 20 20 69 6e 64 65 78 20  e the.    index 
72b0: 6e 61 6d 65 20 61 6e 64 20 61 20 66 6c 61 67 20  name and a flag 
72c0: 74 6f 20 69 6e 64 69 63 61 74 65 20 77 68 65 74  to indicate whet
72d0: 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 69  her or not the i
72e0: 6e 64 65 78 20 6d 75 73 74 20 62 65 0a 20 20 20  ndex must be.   
72f0: 20 75 6e 69 71 75 65 2e 3c 2f 70 3e 0a 0a 3c 6c   unique.</p>..<l
7300: 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 70  i><p><b>PRAGMA p
7310: 61 72 73 65 72 5f 74 72 61 63 65 20 3d 20 4f 4e  arser_trace = ON
7320: 3b 3c 62 72 3e 50 52 41 47 4d 41 20 70 61 72 73  ;<br>PRAGMA pars
7330: 65 72 5f 74 72 61 63 65 20 3d 20 4f 46 46 3b 3c  er_trace = OFF;<
7340: 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 54  /b></p>.    <p>T
7350: 75 72 6e 20 74 72 61 63 69 6e 67 20 6f 66 20 74  urn tracing of t
7360: 68 65 20 53 51 4c 20 70 61 72 73 65 72 20 69 6e  he SQL parser in
7370: 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20 20 20  side of the.    
7380: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 6f  SQLite library o
7390: 6e 20 61 6e 64 20 6f 66 66 2e 20 20 54 68 69 73  n and off.  This
73a0: 20 69 73 20 75 73 65 64 20 66 6f 72 20 64 65 62   is used for deb
73b0: 75 67 67 69 6e 67 2e 0a 20 20 20 20 54 68 69 73  ugging..    This
73c0: 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 69 66 20 74   only works if t
73d0: 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 63 6f  he library is co
73e0: 6d 70 69 6c 65 64 20 77 69 74 68 6f 75 74 20 74  mpiled without t
73f0: 68 65 20 4e 44 45 42 55 47 20 6d 61 63 72 6f 2e  he NDEBUG macro.
7400: 0a 20 20 20 20 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a  .    </p></li>..
7410: 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41  <li><p><b>PRAGMA
7420: 20 74 61 62 6c 65 5f 69 6e 66 6f 28 3c 2f 62 3e   table_info(</b>
7430: 3c 69 3e 74 61 62 6c 65 2d 6e 61 6d 65 3c 2f 69  <i>table-name</i
7440: 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20  ><b>);</b></p>. 
7450: 20 20 20 3c 70 3e 46 6f 72 20 65 61 63 68 20 63     <p>For each c
7460: 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 6e 61 6d  olumn in the nam
7470: 65 64 20 74 61 62 6c 65 2c 20 69 6e 76 6f 6b 65  ed table, invoke
7480: 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 66 75   the callback fu
7490: 6e 63 74 69 6f 6e 0a 20 20 20 20 6f 6e 63 65 20  nction.    once 
74a0: 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  with information
74b0: 20 61 62 6f 75 74 20 74 68 61 74 20 63 6f 6c 75   about that colu
74c0: 6d 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68  mn, including th
74d0: 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 2c 0a 20  e column name,. 
74e0: 20 20 20 64 61 74 61 20 74 79 70 65 2c 20 77 68     data type, wh
74f0: 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65  ether or not the
7500: 20 63 6f 6c 75 6d 6e 20 63 61 6e 20 62 65 20 4e   column can be N
7510: 55 4c 4c 2c 20 61 6e 64 20 74 68 65 20 64 65 66  ULL, and the def
7520: 61 75 6c 74 0a 20 20 20 20 76 61 6c 75 65 20 66  ault.    value f
7530: 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 2e 3c 2f  or the column.</
7540: 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52  p>..<li><p><b>PR
7550: 41 47 4d 41 20 76 64 62 65 5f 74 72 61 63 65 20  AGMA vdbe_trace 
7560: 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41 47 4d 41 20  = ON;<br>PRAGMA 
7570: 76 64 62 65 5f 74 72 61 63 65 20 3d 20 4f 46 46  vdbe_trace = OFF
7580: 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70  ;</b></p>.    <p
7590: 3e 54 75 72 6e 20 74 72 61 63 69 6e 67 20 6f 66  >Turn tracing of
75a0: 20 74 68 65 20 76 69 72 74 75 61 6c 20 64 61 74   the virtual dat
75b0: 61 62 61 73 65 20 65 6e 67 69 6e 65 20 69 6e 73  abase engine ins
75c0: 69 64 65 20 6f 66 20 74 68 65 0a 20 20 20 20 53  ide of the.    S
75d0: 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 6f 6e  QLite library on
75e0: 20 61 6e 64 20 6f 66 66 2e 20 20 54 68 69 73 20   and off.  This 
75f0: 69 73 20 75 73 65 64 20 66 6f 72 20 64 65 62 75  is used for debu
7600: 67 67 69 6e 67 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a  gging.</p></li>.
7610: 3c 2f 75 6c 3e 0a 0a 3c 70 3e 4e 6f 20 65 72 72  </ul>..<p>No err
7620: 6f 72 20 6d 65 73 73 61 67 65 20 69 73 20 67 65  or message is ge
7630: 6e 65 72 61 74 65 64 20 69 66 20 61 6e 20 75 6e  nerated if an un
7640: 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 20 69 73 20  known pragma is 
7650: 69 73 73 75 65 64 2e 0a 55 6e 6b 6e 6f 77 6e 20  issued..Unknown 
7660: 70 72 61 67 6d 61 73 20 61 72 65 20 69 67 6e 6f  pragmas are igno
7670: 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73  red.</p>.}..puts
7680: 20 7b 0a 3c 70 3e 3c 2f 70 3e 0a 7d 0a 0a 70 75   {.<p></p>.}..pu
7690: 74 73 20 7b 0a 3c 70 3e 3c 68 72 20 2f 3e 3c 2f  ts {.<p><hr /></
76a0: 70 3e 0a 3c 70 3e 3c 61 20 68 72 65 66 3d 22 69  p>.<p><a href="i
76b0: 6e 64 65 78 2e 68 74 6d 6c 22 3e 3c 69 6d 67 20  ndex.html"><img 
76c0: 73 72 63 3d 22 2f 67 6f 62 61 63 6b 2e 6a 70 67  src="/goback.jpg
76d0: 22 20 62 6f 72 64 65 72 3d 30 20 2f 3e 0a 42 61  " border=0 />.Ba
76e0: 63 6b 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65  ck to the SQLite
76f0: 20 48 6f 6d 65 20 50 61 67 65 3c 2f 61 3e 0a 3c   Home Page</a>.<
7700: 2f 70 3e 0a 0a 3c 2f 62 6f 64 79 3e 3c 2f 68 74  /p>..</body></ht
7710: 6d 6c 3e 7d 0a                                   ml>}.