/ Hex Artifact Content
Login

Artifact 58077cb0c383fb312c04bf2ab6a80d7b1c525987:


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 32 20 32 30 30 32  .tcl,v 1.22 2002
0060: 2f 30 32 2f 30 33 20 31 39 3a 30 36 3a 30 34 20  /02/03 19:06:04 
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 52 45 50 4c 41  insert}.  {REPLA
0540: 43 45 20 72 65 70 6c 61 63 65 7d 0a 20 20 7b 44  CE replace}.  {D
0550: 45 4c 45 54 45 20 64 65 6c 65 74 65 7d 0a 20 20  ELETE delete}.  
0560: 7b 55 50 44 41 54 45 20 75 70 64 61 74 65 7d 0a  {UPDATE update}.
0570: 20 20 7b 53 45 4c 45 43 54 20 73 65 6c 65 63 74    {SELECT select
0580: 7d 0a 20 20 7b 43 4f 50 59 20 63 6f 70 79 7d 0a  }.  {COPY copy}.
0590: 20 20 7b 45 58 50 4c 41 49 4e 20 65 78 70 6c 61    {EXPLAIN expla
05a0: 69 6e 7d 0a 20 20 7b 65 78 70 72 65 73 73 69 6f  in}.  {expressio
05b0: 6e 20 65 78 70 72 7d 0a 20 20 7b 7b 42 45 47 49  n expr}.  {{BEGI
05c0: 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 7d 20 74  N TRANSACTION} t
05d0: 72 61 6e 73 61 63 74 69 6f 6e 7d 0a 20 20 7b 50  ransaction}.  {P
05e0: 52 41 47 4d 41 20 70 72 61 67 6d 61 7d 0a 20 20  RAGMA pragma}.  
05f0: 7b 7b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c  {{ON CONFLICT cl
0600: 61 75 73 65 7d 20 63 6f 6e 66 6c 69 63 74 7d 0a  ause} conflict}.
0610: 7d 5d 20 7b 0a 20 20 70 75 74 73 20 22 3c 6c 69  }] {.  puts "<li
0620: 3e 3c 61 20 68 72 65 66 3d 5c 22 23 5b 6c 69 6e  ><a href=\"#[lin
0630: 64 65 78 20 24 73 65 63 74 69 6f 6e 20 31 5d 5c  dex $section 1]\
0640: 22 3e 5b 6c 69 6e 64 65 78 20 24 73 65 63 74 69  ">[lindex $secti
0650: 6f 6e 20 30 5d 3c 2f 61 3e 3c 2f 6c 69 3e 22 0a  on 0]</a></li>".
0660: 7d 0a 70 75 74 73 20 7b 3c 2f 75 6c 3e 3c 2f 70  }.puts {</ul></p
0670: 3e 0a 0a 3c 70 3e 44 65 74 61 69 6c 73 20 6f 6e  >..<p>Details on
0680: 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   the implementat
0690: 69 6f 6e 20 6f 66 20 65 61 63 68 20 63 6f 6d 6d  ion of each comm
06a0: 61 6e 64 20 61 72 65 20 70 72 6f 76 69 64 65 64  and are provided
06b0: 20 69 6e 0a 74 68 65 20 73 65 71 75 65 6c 2e 3c   in.the sequel.<
06c0: 2f 70 3e 0a 7d 0a 0a 70 72 6f 63 20 53 79 6e 74  /p>.}..proc Synt
06d0: 61 78 20 7b 61 72 67 73 7d 20 7b 0a 20 20 70 75  ax {args} {.  pu
06e0: 74 73 20 7b 3c 74 61 62 6c 65 20 63 65 6c 6c 70  ts {<table cellp
06f0: 61 64 64 69 6e 67 3d 22 31 30 22 3e 7d 0a 20 20  adding="10">}.  
0700: 66 6f 72 65 61 63 68 20 7b 72 75 6c 65 20 62 6f  foreach {rule bo
0710: 64 79 7d 20 24 61 72 67 73 20 7b 0a 20 20 20 20  dy} $args {.    
0720: 70 75 74 73 20 22 3c 74 72 3e 3c 74 64 20 61 6c  puts "<tr><td al
0730: 69 67 6e 3d 5c 22 72 69 67 68 74 5c 22 20 76 61  ign=\"right\" va
0740: 6c 69 67 6e 3d 5c 22 74 6f 70 5c 22 3e 22 0a 20  lign=\"top\">". 
0750: 20 20 20 70 75 74 73 20 22 3c 69 3e 3c 66 6f 6e     puts "<i><fon
0760: 74 20 63 6f 6c 6f 72 3d 5c 22 23 66 66 33 34 33  t color=\"#ff343
0770: 34 5c 22 3e 24 72 75 6c 65 3c 2f 66 6f 6e 74 3e  4\">$rule</font>
0780: 3c 2f 69 3e 26 6e 62 73 70 3b 3a 3a 3d 3c 2f 74  </i>&nbsp;::=</t
0790: 64 3e 22 0a 20 20 20 20 72 65 67 73 75 62 20 2d  d>".    regsub -
07a0: 61 6c 6c 20 3c 20 24 62 6f 64 79 20 7b 25 4c 54  all < $body {%LT
07b0: 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75  } body.    regsu
07c0: 62 20 2d 61 6c 6c 20 3e 20 24 62 6f 64 79 20 7b  b -all > $body {
07d0: 25 47 54 7d 20 62 6f 64 79 0a 20 20 20 20 72 65  %GT} body.    re
07e0: 67 73 75 62 20 2d 61 6c 6c 20 25 4c 54 20 24 62  gsub -all %LT $b
07f0: 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f 62 3e  ody {</font></b>
0800: 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22  <i><font color="
0810: 23 66 66 33 34 33 34 22 3e 7d 20 62 6f 64 79 0a  #ff3434">} body.
0820: 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20      regsub -all 
0830: 25 47 54 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e  %GT $body {</fon
0840: 74 3e 3c 2f 69 3e 3c 62 3e 3c 66 6f 6e 74 20 63  t></i><b><font c
0850: 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e 7d  olor="#2c2cf0">}
0860: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
0870: 20 2d 61 6c 6c 20 7b 5b 5d 7c 5b 2a 3f 5d 7d 20   -all {[]|[*?]} 
0880: 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f  $body {</font></
0890: 62 3e 26 3c 62 3e 3c 66 6f 6e 74 20 63 6f 6c 6f  b>&<b><font colo
08a0: 72 3d 22 23 32 63 32 63 66 30 22 3e 7d 20 62 6f  r="#2c2cf0">} bo
08b0: 64 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61  dy.    regsub -a
08c0: 6c 6c 20 22 5c 6e 22 20 5b 73 74 72 69 6e 67 20  ll "\n" [string 
08d0: 74 72 69 6d 20 24 62 6f 64 79 5d 20 22 3c 62 72  trim $body] "<br
08e0: 3e 5c 6e 22 20 62 6f 64 79 0a 20 20 20 20 72 65  >\n" body.    re
08f0: 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 20 20 2a  gsub -all "\n  *
0900: 22 20 24 62 6f 64 79 20 22 5c 6e 5c 5c 26 6e 62  " $body "\n\\&nb
0910: 73 70 3b 5c 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62  sp;\\&nbsp;\\&nb
0920: 73 70 3b 5c 5c 26 6e 62 73 70 3b 22 20 62 6f 64  sp;\\&nbsp;" bod
0930: 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c  y.    regsub -al
0940: 6c 20 7b 5b 7c 2c 2e 2a 28 29 5d 7d 20 24 62 6f  l {[|,.*()]} $bo
0950: 64 79 20 7b 3c 62 69 67 3e 26 3c 2f 62 69 67 3e  dy {<big>&</big>
0960: 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75  } body.    regsu
0970: 62 20 2d 61 6c 6c 20 7b 20 3d 20 7d 20 24 62 6f  b -all { = } $bo
0980: 64 79 20 7b 20 3c 62 69 67 3e 3d 3c 2f 62 69 67  dy { <big>=</big
0990: 3e 20 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67  > } body.    reg
09a0: 73 75 62 20 2d 61 6c 6c 20 7b 53 54 41 52 7d 20  sub -all {STAR} 
09b0: 24 62 6f 64 79 20 7b 3c 62 69 67 3e 2a 3c 2f 62  $body {<big>*</b
09c0: 69 67 3e 7d 20 62 6f 64 79 0a 20 20 20 20 70 75  ig>} body.    pu
09d0: 74 73 20 22 3c 74 64 3e 3c 62 3e 3c 66 6f 6e 74  ts "<td><b><font
09e0: 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32 63 66 30   color=\"#2c2cf0
09f0: 5c 22 3e 24 62 6f 64 79 3c 2f 66 6f 6e 74 3e 3c  \">$body</font><
0a00: 2f 62 3e 3c 2f 74 64 3e 3c 2f 74 72 3e 22 0a 20  /b></td></tr>". 
0a10: 20 7d 0a 20 20 70 75 74 73 20 7b 3c 2f 74 61 62   }.  puts {</tab
0a20: 6c 65 3e 7d 0a 7d 0a 70 72 6f 63 20 4f 70 65 72  le>}.}.proc Oper
0a30: 61 74 6f 72 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20  ator {name} {.  
0a40: 72 65 74 75 72 6e 20 22 3c 66 6f 6e 74 20 63 6f  return "<font co
0a50: 6c 6f 72 3d 5c 22 23 32 63 32 63 66 30 5c 22 3e  lor=\"#2c2cf0\">
0a60: 3c 62 69 67 3e 24 6e 61 6d 65 3c 2f 62 69 67 3e  <big>$name</big>
0a70: 3c 2f 66 6f 6e 74 3e 22 0a 7d 0a 70 72 6f 63 20  </font>".}.proc 
0a80: 4e 6f 6e 74 65 72 6d 69 6e 61 6c 20 7b 6e 61 6d  Nonterminal {nam
0a90: 65 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 22 3c  e} {.  return "<
0aa0: 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22  i><font color=\"
0ab0: 23 66 66 33 34 33 34 5c 22 3e 24 6e 61 6d 65 3c  #ff3434\">$name<
0ac0: 2f 66 6f 6e 74 3e 3c 2f 69 3e 22 0a 7d 0a 70 72  /font></i>".}.pr
0ad0: 6f 63 20 4b 65 79 77 6f 72 64 20 7b 6e 61 6d 65  oc Keyword {name
0ae0: 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 22 3c 66  } {.  return "<f
0af0: 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32  ont color=\"#2c2
0b00: 63 66 30 5c 22 3e 24 6e 61 6d 65 3c 2f 66 6f 6e  cf0\">$name</fon
0b10: 74 3e 22 0a 7d 0a 20 0a 0a 70 72 6f 63 20 53 65  t>".}. ..proc Se
0b20: 63 74 69 6f 6e 20 7b 6e 61 6d 65 20 7b 6c 61 62  ction {name {lab
0b30: 65 6c 20 7b 7d 7d 7d 20 7b 0a 20 20 70 75 74 73  el {}}} {.  puts
0b40: 20 22 5c 6e 3c 68 72 20 2f 3e 22 0a 20 20 69 66   "\n<hr />".  if
0b50: 20 7b 24 6c 61 62 65 6c 21 3d 22 22 7d 20 7b 0a   {$label!=""} {.
0b60: 20 20 20 20 70 75 74 73 20 22 3c 61 20 6e 61 6d      puts "<a nam
0b70: 65 3d 5c 22 24 6c 61 62 65 6c 5c 22 3e 22 0a 20  e=\"$label\">". 
0b80: 20 7d 0a 20 20 70 75 74 73 20 22 3c 68 31 3e 24   }.  puts "<h1>$
0b90: 6e 61 6d 65 3c 2f 68 31 3e 5c 6e 22 0a 7d 0a 0a  name</h1>\n".}..
0ba0: 70 72 6f 63 20 45 78 61 6d 70 6c 65 20 7b 74 65  proc Example {te
0bb0: 78 74 7d 20 7b 0a 20 20 70 75 74 73 20 22 3c 62  xt} {.  puts "<b
0bc0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 24  lockquote><pre>$
0bd0: 74 65 78 74 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63  text</pre></bloc
0be0: 6b 71 75 6f 74 65 3e 22 0a 7d 0a 0a 53 65 63 74  kquote>".}..Sect
0bf0: 69 6f 6e 20 7b 42 45 47 49 4e 20 54 52 41 4e 53  ion {BEGIN TRANS
0c00: 41 43 54 49 4f 4e 7d 20 63 72 65 61 74 65 69 6e  ACTION} createin
0c10: 64 65 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  dex..Syntax {sql
0c20: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 42 45  -statement} {.BE
0c30: 47 49 4e 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e  GIN [TRANSACTION
0c40: 20 5b 3c 6e 61 6d 65 3e 5d 5d 20 5b 4f 4e 20 43   [<name>]] [ON C
0c50: 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63  ONFLICT <conflic
0c60: 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 5d 0a 7d 0a  t-algorithm>].}.
0c70: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
0c80: 65 6d 65 6e 74 7d 20 7b 0a 45 4e 44 20 5b 54 52  ement} {.END [TR
0c90: 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65  ANSACTION [<name
0ca0: 3e 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b 73 71  >]].}.Syntax {sq
0cb0: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43  l-statement} {.C
0cc0: 4f 4d 4d 49 54 20 5b 54 52 41 4e 53 41 43 54 49  OMMIT [TRANSACTI
0cd0: 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 53  ON [<name>]].}.S
0ce0: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
0cf0: 6d 65 6e 74 7d 20 7b 0a 52 4f 4c 4c 42 41 43 4b  ment} {.ROLLBACK
0d00: 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c   [TRANSACTION [<
0d10: 6e 61 6d 65 3e 5d 5d 0a 7d 0a 0a 70 75 74 73 20  name>]].}..puts 
0d20: 7b 0a 3c 70 3e 42 65 67 69 6e 6e 69 6e 67 20 69  {.<p>Beginning i
0d30: 6e 20 76 65 72 73 69 6f 6e 20 32 2e 30 2c 20 53  n version 2.0, S
0d40: 51 4c 69 74 65 20 73 75 70 70 6f 72 74 73 20 74  QLite supports t
0d50: 72 61 6e 73 61 63 74 69 6f 6e 73 20 77 69 74 68  ransactions with
0d60: 0a 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 61 74  .rollback and at
0d70: 6f 6d 69 63 20 63 6f 6d 6d 69 74 2e 3c 2f 70 3e  omic commit.</p>
0d80: 0a 0a 3c 70 3e 0a 4e 6f 20 63 68 61 6e 67 65 73  ..<p>.No changes
0d90: 20 63 61 6e 20 62 65 20 6d 61 64 65 20 74 6f 20   can be made to 
0da0: 74 68 65 20 64 61 74 61 62 61 73 65 20 65 78 63  the database exc
0db0: 65 70 74 20 77 69 74 68 69 6e 20 61 20 74 72 61  ept within a tra
0dc0: 6e 73 61 63 74 69 6f 6e 2e 0a 41 6e 79 20 63 6f  nsaction..Any co
0dd0: 6d 6d 61 6e 64 20 74 68 61 74 20 63 68 61 6e 67  mmand that chang
0de0: 65 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20  es the database 
0df0: 28 62 61 73 69 63 61 6c 6c 79 2c 20 61 6e 79 20  (basically, any 
0e00: 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 6f 74 68 65  SQL command.othe
0e10: 72 20 74 68 61 6e 20 53 45 4c 45 43 54 29 20 77  r than SELECT) w
0e20: 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  ill automaticall
0e30: 79 20 73 74 61 72 74 73 20 61 20 74 72 61 6e 73  y starts a trans
0e40: 61 63 74 69 6f 6e 20 69 66 0a 6f 6e 65 20 69 73  action if.one is
0e50: 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e 20   not already in 
0e60: 65 66 66 65 63 74 2e 20 20 41 75 74 6f 6d 61 74  effect.  Automat
0e70: 69 63 61 6c 6c 79 20 73 74 61 72 65 64 20 74 72  ically stared tr
0e80: 61 6e 73 61 63 74 69 6f 6e 73 0a 61 72 65 20 63  ansactions.are c
0e90: 6f 6d 6d 69 74 74 65 64 20 61 74 20 74 68 65 20  ommitted at the 
0ea0: 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 74 68  conclusion of th
0eb0: 65 20 63 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70 3e 0a  e command..</p>.
0ec0: 0a 3c 70 3e 0a 54 72 61 6e 73 61 63 74 69 6f 6e  .<p>.Transaction
0ed0: 73 20 63 61 6e 20 62 65 20 73 74 61 72 74 65 64  s can be started
0ee0: 20 6d 61 6e 75 61 6c 6c 79 20 75 73 69 6e 67 20   manually using 
0ef0: 74 68 65 20 42 45 47 49 4e 0a 63 6f 6d 6d 61 6e  the BEGIN.comman
0f00: 64 2e 20 53 75 63 68 20 74 72 61 6e 73 61 63 74  d. Such transact
0f10: 69 6f 6e 73 20 75 73 75 61 6c 6c 79 20 70 65 72  ions usually per
0f20: 73 69 73 74 20 75 6e 74 69 6c 20 74 68 65 20 6e  sist until the n
0f30: 65 78 74 0a 43 4f 4d 4d 49 54 20 6f 72 20 52 4f  ext.COMMIT or RO
0f40: 4c 4c 42 41 43 4b 20 63 6f 6d 6d 61 6e 64 2e 20  LLBACK command. 
0f50: 42 75 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f  But a transactio
0f60: 6e 20 77 69 6c 6c 20 61 6c 73 6f 20 0a 52 4f 4c  n will also .ROL
0f70: 4c 42 41 43 4b 20 69 66 20 74 68 65 20 64 61 74  LBACK if the dat
0f80: 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 20  abase is closed 
0f90: 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f  or if an error o
0fa0: 63 63 75 72 73 0a 61 6e 64 20 74 68 65 20 52 4f  ccurs.and the RO
0fb0: 4c 4c 42 41 43 4b 20 63 6f 6e 66 6c 69 63 74 20  LLBACK conflict 
0fc0: 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72  resolution algor
0fd0: 69 74 68 6d 20 69 73 20 73 70 65 63 69 66 69 65  ithm is specifie
0fe0: 64 2e 0a 53 65 65 20 74 68 65 20 64 6f 63 75 6d  d..See the docum
0ff0: 65 6e 74 69 6f 6e 20 6f 6e 20 74 68 65 20 3c 61  ention on the <a
1000: 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74   href="#conflict
1010: 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61  ">ON CONFLICT</a
1020: 3e 0a 63 6c 61 75 73 65 20 66 6f 72 20 61 64 64  >.clause for add
1030: 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74  itional informat
1040: 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 52 4f  ion about the RO
1050: 4c 4c 42 41 43 4b 0a 63 6f 6e 66 6c 69 63 74 20  LLBACK.conflict 
1060: 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72  resolution algor
1070: 69 74 68 6d 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  ithm..</p>..<p>.
1080: 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 4f 4e 20  The optional ON 
1090: 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 20  CONFLICT clause 
10a0: 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20  at the end of a 
10b0: 42 45 47 49 4e 20 73 74 61 74 65 6d 65 6e 74 0a  BEGIN statement.
10c0: 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63  can be used to c
10d0: 68 61 6e 67 65 64 20 74 68 65 20 64 65 66 61 75  hanged the defau
10e0: 6c 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f  lt conflict reso
10f0: 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d  lution algorithm
1100: 2e 0a 54 68 65 20 6e 6f 72 6d 61 6c 20 64 65 66  ..The normal def
1110: 61 75 6c 74 20 69 73 20 41 42 4f 52 54 2e 20 20  ault is ABORT.  
1120: 49 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76  If an alternativ
1130: 65 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62  e is specified b
1140: 79 0a 74 68 65 20 4f 4e 20 43 4f 4e 46 4c 49 43  y.the ON CONFLIC
1150: 54 20 63 6c 61 75 73 65 20 6f 66 20 61 20 42 45  T clause of a BE
1160: 47 49 4e 2c 20 74 68 65 6e 20 74 68 61 74 20 61  GIN, then that a
1170: 6c 74 65 72 6e 61 74 69 76 65 20 69 73 20 75 73  lternative is us
1180: 65 64 0a 61 73 20 74 68 65 20 64 65 66 61 75 6c  ed.as the defaul
1190: 74 20 66 6f 72 20 61 6c 6c 20 63 6f 6d 6d 61 6e  t for all comman
11a0: 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 74 72  ds within the tr
11b0: 61 6e 73 61 63 74 69 6f 6e 2e 20 20 54 68 65 20  ansaction.  The 
11c0: 64 65 66 61 75 6c 74 0a 61 6c 67 6f 72 69 74 68  default.algorith
11d0: 6d 20 69 73 20 6f 76 65 72 72 69 64 64 65 6e 20  m is overridden 
11e0: 62 79 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63  by ON CONFLICT c
11f0: 6c 61 75 73 65 73 20 6f 6e 20 69 6e 64 69 76 69  lauses on indivi
1200: 64 75 61 6c 0a 63 6f 6e 73 74 72 61 69 6e 74 73  dual.constraints
1210: 20 77 69 74 68 69 6e 20 74 68 65 20 43 52 45 41   within the CREA
1220: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
1230: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
1240: 6e 74 73 0a 61 6e 64 20 62 79 20 74 68 65 20 4f  nts.and by the O
1250: 52 20 63 6c 61 75 73 65 73 20 6f 6e 20 43 4f 50  R clauses on COP
1260: 59 2c 20 49 4e 53 45 52 54 2c 20 61 6e 64 20 55  Y, INSERT, and U
1270: 50 44 41 54 45 20 63 6f 6d 6d 61 6e 64 73 2e 0a  PDATE commands..
1280: 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20  </p>.}..Section 
1290: 43 4f 50 59 20 63 6f 70 79 0a 0a 53 79 6e 74 61  COPY copy..Synta
12a0: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
12b0: 7d 20 7b 0a 43 4f 50 59 20 5b 20 4f 52 20 3c 63  } {.COPY [ OR <c
12c0: 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68  onflict-algorith
12d0: 6d 3e 20 5d 20 3c 74 61 62 6c 65 2d 6e 61 6d 65  m> ] <table-name
12e0: 3e 20 46 52 4f 4d 20 3c 66 69 6c 65 6e 61 6d 65  > FROM <filename
12f0: 3e 0a 5b 20 55 53 49 4e 47 20 44 45 4c 49 4d 49  >.[ USING DELIMI
1300: 54 45 52 53 20 3c 64 65 6c 69 6d 3e 20 5d 0a 7d  TERS <delim> ].}
1310: 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  ...puts {.<p>The
1320: 20 43 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73   COPY command is
1330: 20 61 6e 20 65 78 74 65 6e 73 69 6f 6e 20 75 73   an extension us
1340: 65 64 20 74 6f 20 6c 6f 61 64 20 6c 61 72 67 65  ed to load large
1350: 20 61 6d 6f 75 6e 74 73 20 6f 66 0a 64 61 74 61   amounts of.data
1360: 20 69 6e 74 6f 20 61 20 74 61 62 6c 65 2e 20 20   into a table.  
1370: 49 74 20 69 73 20 6d 6f 64 65 6c 65 64 20 61 66  It is modeled af
1380: 74 65 72 20 61 20 73 69 6d 69 6c 61 72 20 63 6f  ter a similar co
1390: 6d 6d 61 6e 64 20 66 6f 75 6e 64 0a 69 6e 20 50  mmand found.in P
13a0: 6f 73 74 67 72 65 53 51 4c 2e 20 20 49 6e 20 66  ostgreSQL.  In f
13b0: 61 63 74 2c 20 74 68 65 20 53 51 4c 69 74 65 20  act, the SQLite 
13c0: 43 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73 20  COPY command is 
13d0: 73 70 65 63 69 66 69 63 61 6c 6c 79 0a 64 65 73  specifically.des
13e0: 69 67 6e 65 64 20 74 6f 20 62 65 20 61 62 6c 65  igned to be able
13f0: 20 74 6f 20 72 65 61 64 20 74 68 65 20 6f 75 74   to read the out
1400: 70 75 74 20 6f 66 20 74 68 65 20 50 6f 73 74 67  put of the Postg
1410: 72 65 53 51 4c 20 64 75 6d 70 0a 75 74 69 6c 69  reSQL dump.utili
1420: 74 79 20 3c 62 3e 70 67 5f 64 75 6d 70 3c 2f 62  ty <b>pg_dump</b
1430: 3e 20 73 6f 20 74 68 61 74 20 64 61 74 61 20 63  > so that data c
1440: 61 6e 20 62 65 20 65 61 73 69 6c 79 20 74 72 61  an be easily tra
1450: 6e 73 66 65 72 72 65 64 20 66 72 6f 6d 0a 50 6f  nsferred from.Po
1460: 73 74 67 72 65 53 51 4c 20 69 6e 74 6f 20 53 51  stgreSQL into SQ
1470: 4c 69 74 65 2e 3c 70 3e 0a 0a 3c 70 3e 54 68 65  Lite.<p>..<p>The
1480: 20 74 61 62 6c 65 2d 6e 61 6d 65 20 69 73 20 74   table-name is t
1490: 68 65 20 6e 61 6d 65 20 6f 66 20 61 6e 20 65 78  he name of an ex
14a0: 69 73 74 69 6e 67 20 74 61 62 6c 65 20 77 68 69  isting table whi
14b0: 63 68 20 69 73 20 74 6f 0a 62 65 20 66 69 6c 6c  ch is to.be fill
14c0: 65 64 20 77 69 74 68 20 64 61 74 61 2e 20 20 54  ed with data.  T
14d0: 68 65 20 66 69 6c 65 6e 61 6d 65 20 69 73 20 61  he filename is a
14e0: 20 73 74 72 69 6e 67 20 6f 72 20 69 64 65 6e 74   string or ident
14f0: 69 66 69 65 72 20 74 68 61 74 0a 6e 61 6d 65 73  ifier that.names
1500: 20 61 20 66 69 6c 65 20 66 72 6f 6d 20 77 68 69   a file from whi
1510: 63 68 20 64 61 74 61 20 77 69 6c 6c 20 62 65 20  ch data will be 
1520: 72 65 61 64 2e 20 20 54 68 65 20 66 69 6c 65 6e  read.  The filen
1530: 61 6d 65 20 63 61 6e 20 62 65 0a 74 68 65 20 3c  ame can be.the <
1540: 62 3e 53 54 44 49 4e 3c 2f 62 3e 20 74 6f 20 72  b>STDIN</b> to r
1550: 65 61 64 20 64 61 74 61 20 66 72 6f 6d 20 73 74  ead data from st
1560: 61 6e 64 61 72 64 20 69 6e 70 75 74 2e 3c 70 3e  andard input.<p>
1570: 0a 0a 3c 70 3e 45 61 63 68 20 6c 69 6e 65 20 6f  ..<p>Each line o
1580: 66 20 74 68 65 20 69 6e 70 75 74 20 66 69 6c 65  f the input file
1590: 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 69 6e   is converted in
15a0: 74 6f 20 61 20 73 69 6e 67 6c 65 20 72 65 63 6f  to a single reco
15b0: 72 64 0a 69 6e 20 74 68 65 20 74 61 62 6c 65 2e  rd.in the table.
15c0: 20 20 43 6f 6c 75 6d 6e 73 20 61 72 65 20 73 65    Columns are se
15d0: 70 61 72 61 74 65 64 20 62 79 20 74 61 62 73 2e  parated by tabs.
15e0: 20 20 49 66 20 61 20 74 61 62 20 6f 63 63 75 72    If a tab occur
15f0: 73 20 61 73 0a 64 61 74 61 20 77 69 74 68 69 6e  s as.data within
1600: 20 61 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20   a column, then 
1610: 74 68 61 74 20 74 61 62 20 69 73 20 70 72 65 63  that tab is prec
1620: 65 64 65 64 20 62 79 20 61 20 62 61 73 6b 73 6c  eded by a basksl
1630: 61 73 68 20 22 5c 22 0a 63 68 61 72 61 63 74 65  ash "\".characte
1640: 72 2e 20 20 41 20 62 61 73 6b 73 6c 61 73 68 20  r.  A baskslash 
1650: 69 6e 20 74 68 65 20 64 61 74 61 20 61 70 70 65  in the data appe
1660: 61 72 73 20 61 73 20 74 77 6f 20 62 61 63 6b 73  ars as two backs
1670: 6c 61 73 68 65 73 20 69 6e 0a 61 20 72 6f 77 2e  lashes in.a row.
1680: 20 20 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 55    The optional U
1690: 53 49 4e 47 20 44 45 4c 49 4d 49 54 45 52 53 20  SING DELIMITERS 
16a0: 63 6c 61 75 73 65 20 63 61 6e 20 73 70 65 63 69  clause can speci
16b0: 66 79 20 61 20 64 65 6c 69 6d 69 74 65 72 0a 6f  fy a delimiter.o
16c0: 74 68 65 72 20 74 68 61 6e 20 74 61 62 2e 3c 2f  ther than tab.</
16d0: 70 3e 0a 0a 3c 70 3e 49 66 20 61 20 63 6f 6c 75  p>..<p>If a colu
16e0: 6d 6e 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  mn consists of t
16f0: 68 65 20 63 68 61 72 61 63 74 65 72 20 22 5c 4e  he character "\N
1700: 22 2c 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20 69  ", that column i
1710: 73 20 66 69 6c 6c 65 64 0a 77 69 74 68 20 74 68  s filled.with th
1720: 65 20 76 61 6c 75 65 20 4e 55 4c 4c 2e 3c 2f 70  e value NULL.</p
1730: 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e  >..<p>The option
1740: 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  al conflict-clau
1750: 73 65 20 61 6c 6c 6f 77 73 20 74 68 65 20 73 70  se allows the sp
1760: 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 61  ecification of a
1770: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 63 6f  n alternative.co
1780: 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c 69 63  nstraint conflic
1790: 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67  t resolution alg
17a0: 6f 72 69 74 68 6d 20 74 6f 20 75 73 65 20 66 6f  orithm to use fo
17b0: 72 20 74 68 69 73 20 6f 6e 65 20 63 6f 6d 6d 61  r this one comma
17c0: 6e 64 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74  nd..See the sect
17d0: 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72  ion titled.<a hr
17e0: 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f  ef="#conflict">O
17f0: 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66  N CONFLICT</a> f
1800: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  or additional in
1810: 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  formation.</p>..
1820: 3c 70 3e 57 68 65 6e 20 74 68 65 20 69 6e 70 75  <p>When the inpu
1830: 74 20 64 61 74 61 20 73 6f 75 72 63 65 20 69 73  t data source is
1840: 20 53 54 44 49 4e 2c 20 74 68 65 20 69 6e 70 75   STDIN, the inpu
1850: 74 20 63 61 6e 20 62 65 20 74 65 72 6d 69 6e 61  t can be termina
1860: 74 65 64 0a 62 79 20 61 20 6c 69 6e 65 20 74 68  ted.by a line th
1870: 61 74 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 6c 79  at contains only
1880: 20 61 20 62 61 73 6b 73 6c 61 73 68 20 61 6e 64   a baskslash and
1890: 20 61 20 64 6f 74 3a 7d 0a 70 75 74 73 20 22 5c   a dot:}.puts "\
18a0: 22 5b 4f 70 65 72 61 74 6f 72 20 5c 5c 2e 5d 5c  "[Operator \\.]\
18b0: 22 2e 3c 2f 70 3e 22 0a 0a 53 65 63 74 69 6f 6e  ".</p>"..Section
18c0: 20 7b 43 52 45 41 54 45 20 49 4e 44 45 58 7d 20   {CREATE INDEX} 
18d0: 63 72 65 61 74 65 69 6e 64 65 78 0a 0a 53 79 6e  createindex..Syn
18e0: 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65  tax {sql-stateme
18f0: 6e 74 7d 20 7b 0a 43 52 45 41 54 45 20 5b 55 4e  nt} {.CREATE [UN
1900: 49 51 55 45 5d 20 49 4e 44 45 58 20 3c 69 6e 64  IQUE] INDEX <ind
1910: 65 78 2d 6e 61 6d 65 3e 20 0a 4f 4e 20 3c 74 61  ex-name> .ON <ta
1920: 62 6c 65 2d 6e 61 6d 65 3e 20 28 20 3c 63 6f 6c  ble-name> ( <col
1930: 75 6d 6e 2d 6e 61 6d 65 3e 20 5b 2c 20 3c 63 6f  umn-name> [, <co
1940: 6c 75 6d 6e 2d 6e 61 6d 65 3e 5d 2a 20 29 0a 5b  lumn-name>]* ).[
1950: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 63 6f   ON CONFLICT <co
1960: 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d  nflict-algorithm
1970: 3e 20 5d 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 6e 61  > ].} {column-na
1980: 6d 65 7d 20 7b 0a 3c 6e 61 6d 65 3e 20 5b 20 41  me} {.<name> [ A
1990: 53 43 20 7c 20 44 45 53 43 20 5d 0a 7d 0a 0a 0a  SC | DESC ].}...
19a0: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 43 52  puts {.<p>The CR
19b0: 45 41 54 45 20 49 4e 44 45 58 20 63 6f 6d 6d 61  EATE INDEX comma
19c0: 6e 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  nd consists of t
19d0: 68 65 20 6b 65 79 77 6f 72 64 73 20 22 43 52 45  he keywords "CRE
19e0: 41 54 45 20 49 4e 44 45 58 22 20 66 6f 6c 6c 6f  ATE INDEX" follo
19f0: 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20  wed.by the name 
1a00: 6f 66 20 74 68 65 20 6e 65 77 20 69 6e 64 65 78  of the new index
1a10: 2c 20 74 68 65 20 6b 65 79 77 6f 72 64 20 22 4f  , the keyword "O
1a20: 4e 22 2c 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  N", the name of 
1a30: 61 20 70 72 65 76 69 6f 75 73 6c 79 0a 63 72 65  a previously.cre
1a40: 61 74 65 64 20 74 61 62 6c 65 20 74 68 61 74 20  ated table that 
1a50: 69 73 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64  is to be indexed
1a60: 2c 20 61 6e 64 20 61 20 70 61 72 65 6e 74 68 65  , and a parenthe
1a70: 73 69 7a 65 64 20 6c 69 73 74 20 6f 66 20 6e 61  sized list of na
1a80: 6d 65 73 20 6f 66 0a 63 6f 6c 75 6d 6e 73 20 69  mes of.columns i
1a90: 6e 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74  n the table that
1aa0: 20 61 72 65 20 75 73 65 64 20 66 6f 72 20 74 68   are used for th
1ab0: 65 20 69 6e 64 65 78 20 6b 65 79 2e 0a 45 61 63  e index key..Eac
1ac0: 68 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61  h column name ca
1ad0: 6e 20 62 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79  n be followed by
1ae0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 22 41 53 43   one of the "ASC
1af0: 22 20 6f 72 20 22 44 45 53 43 22 20 6b 65 79 77  " or "DESC" keyw
1b00: 6f 72 64 73 0a 74 6f 20 69 6e 64 69 63 61 74 65  ords.to indicate
1b10: 20 73 6f 72 74 20 6f 72 64 65 72 2c 20 62 75 74   sort order, but
1b20: 20 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72 20   the sort order 
1b30: 69 73 20 69 67 6e 6f 72 65 64 20 69 6e 20 74 68  is ignored in th
1b40: 65 20 63 75 72 72 65 6e 74 0a 69 6d 70 6c 65 6d  e current.implem
1b50: 65 6e 74 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c  entation.</p>..<
1b60: 70 3e 54 68 65 72 65 20 61 72 65 20 6e 6f 20 61  p>There are no a
1b70: 72 62 69 74 72 61 72 79 20 6c 69 6d 69 74 73 20  rbitrary limits 
1b80: 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  on the number of
1b90: 20 69 6e 64 69 63 65 73 20 74 68 61 74 20 63 61   indices that ca
1ba0: 6e 20 62 65 0a 61 74 74 61 63 68 65 64 20 74 6f  n be.attached to
1bb0: 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 2c   a single table,
1bc0: 20 6e 6f 72 20 6f 6e 20 74 68 65 20 6e 75 6d 62   nor on the numb
1bd0: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e  er of columns in
1be0: 20 61 6e 20 69 6e 64 65 78 2e 3c 2f 70 3e 0a 0a   an index.</p>..
1bf0: 3c 70 3e 49 66 20 74 68 65 20 55 4e 49 51 55 45  <p>If the UNIQUE
1c00: 20 6b 65 79 77 6f 72 64 20 61 70 70 65 61 72 73   keyword appears
1c10: 20 62 65 74 77 65 65 6e 20 43 52 45 41 54 45 20   between CREATE 
1c20: 61 6e 64 20 49 4e 44 45 58 20 74 68 65 6e 20 64  and INDEX then d
1c30: 75 70 6c 69 63 61 74 65 0a 69 6e 64 65 78 20 65  uplicate.index e
1c40: 6e 74 72 69 65 73 20 61 72 65 20 6e 6f 74 20 61  ntries are not a
1c50: 6c 6c 6f 77 65 64 2e 20 20 41 6e 79 20 61 74 74  llowed.  Any att
1c60: 65 6d 70 74 20 74 6f 20 69 6e 73 65 72 74 20 61  empt to insert a
1c70: 20 64 75 70 6c 69 63 61 74 65 20 65 6e 74 72 79   duplicate entry
1c80: 0a 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20  .will result in 
1c90: 61 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 61  a rollback and a
1ca0: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e  n error message.
1cb0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74  </p>..<p>The opt
1cc0: 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63  ional conflict-c
1cd0: 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20 74 68 65  lause allows the
1ce0: 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 6f   specification o
1cf0: 66 20 61 6c 20 61 6c 74 65 72 6e 61 74 69 76 65  f al alternative
1d00: 0a 64 65 66 61 75 6c 74 20 63 6f 6e 73 74 72 61  .default constra
1d10: 69 6e 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73  int conflict res
1d20: 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  olution algorith
1d30: 6d 20 66 6f 72 20 74 68 69 73 20 69 6e 64 65 78  m for this index
1d40: 2e 0a 54 68 69 73 20 6f 6e 6c 79 20 6d 61 6b 65  ..This only make
1d50: 73 20 73 65 6e 73 65 20 69 66 20 74 68 65 20 55  s sense if the U
1d60: 4e 49 51 55 45 20 6b 65 79 77 6f 72 64 20 69 73  NIQUE keyword is
1d70: 20 75 73 65 64 20 73 69 6e 63 65 20 6f 74 68 65   used since othe
1d80: 72 77 69 73 65 0a 74 68 65 72 65 20 61 72 65 20  rwise.there are 
1d90: 6e 6f 74 20 63 6f 6e 73 74 72 61 69 6e 74 73 20  not constraints 
1da0: 6f 6e 20 74 68 65 20 69 6e 64 65 78 2e 20 20 54  on the index.  T
1db0: 68 65 20 64 65 66 61 75 6c 74 20 61 6c 67 6f 72  he default algor
1dc0: 69 74 68 6d 20 69 73 0a 41 42 4f 52 54 2e 20 20  ithm is.ABORT.  
1dd0: 49 66 20 61 20 43 4f 50 59 2c 20 49 4e 53 45 52  If a COPY, INSER
1de0: 54 2c 20 6f 72 20 55 50 44 41 54 45 20 73 74 61  T, or UPDATE sta
1df0: 74 65 6d 65 6e 74 20 73 70 65 63 69 66 69 65 73  tement specifies
1e00: 20 61 20 70 61 72 74 69 63 75 6c 61 72 0a 63 6f   a particular.co
1e10: 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f  nflict resolutio
1e20: 6e 20 61 6c 67 6f 72 69 74 68 6d 2c 20 74 68 61  n algorithm, tha
1e30: 74 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 75  t algorithm is u
1e40: 73 65 64 20 69 6e 20 70 6c 61 63 65 20 6f 66 0a  sed in place of.
1e50: 74 68 65 20 64 65 66 61 75 6c 74 20 61 6c 67 6f  the default algo
1e60: 72 69 74 68 6d 20 73 70 65 63 69 66 69 65 64 20  rithm specified 
1e70: 68 65 72 65 2e 0a 53 65 65 20 74 68 65 20 73 65  here..See the se
1e80: 63 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20  ction titled.<a 
1e90: 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22  href="#conflict"
1ea0: 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e  >ON CONFLICT</a>
1eb0: 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20   for additional 
1ec0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e  information.</p>
1ed0: 0a 0a 3c 70 3e 54 68 65 20 65 78 61 63 74 20 74  ..<p>The exact t
1ee0: 65 78 74 0a 6f 66 20 65 61 63 68 20 43 52 45 41  ext.of each CREA
1ef0: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
1f00: 6e 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20  nt is stored in 
1f10: 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61  the <b>sqlite_ma
1f20: 73 74 65 72 3c 2f 62 3e 0a 74 61 62 6c 65 2e 20  ster</b>.table. 
1f30: 20 45 76 65 72 79 74 69 6d 65 20 74 68 65 20 64   Everytime the d
1f40: 61 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e 65  atabase is opene
1f50: 64 2c 20 61 6c 6c 20 43 52 45 41 54 45 20 49 4e  d, all CREATE IN
1f60: 44 45 58 20 73 74 61 74 65 6d 65 6e 74 73 0a 61  DEX statements.a
1f70: 72 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65  re read from the
1f80: 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65   <b>sqlite_maste
1f90: 72 3c 2f 62 3e 20 74 61 62 6c 65 20 61 6e 64 20  r</b> table and 
1fa0: 75 73 65 64 20 74 6f 20 72 65 67 65 6e 65 72 61  used to regenera
1fb0: 74 65 0a 53 51 4c 69 74 65 27 73 20 69 6e 74 65  te.SQLite's inte
1fc0: 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61 74  rnal representat
1fd0: 69 6f 6e 20 6f 66 20 74 68 65 20 69 6e 64 65 78  ion of the index
1fe0: 20 6c 61 79 6f 75 74 2e 3c 2f 70 3e 0a 7d 0a 0a   layout.</p>.}..
1ff0: 0a 53 65 63 74 69 6f 6e 20 7b 43 52 45 41 54 45  .Section {CREATE
2000: 20 54 41 42 4c 45 7d 20 7b 63 72 65 61 74 65 74   TABLE} {createt
2010: 61 62 6c 65 7d 0a 0a 53 79 6e 74 61 78 20 7b 73  able}..Syntax {s
2020: 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 43 52  ql-command} {.CR
2030: 45 41 54 45 20 5b 54 45 4d 50 20 7c 20 54 45 4d  EATE [TEMP | TEM
2040: 50 4f 52 41 52 59 5d 20 54 41 42 4c 45 20 3c 74  PORARY] TABLE <t
2050: 61 62 6c 65 2d 6e 61 6d 65 3e 20 28 0a 20 20 3c  able-name> (.  <
2060: 63 6f 6c 75 6d 6e 2d 64 65 66 3e 20 5b 2c 20 3c  column-def> [, <
2070: 63 6f 6c 75 6d 6e 2d 64 65 66 3e 5d 2a 0a 20 20  column-def>]*.  
2080: 5b 2c 20 3c 63 6f 6e 73 74 72 61 69 6e 74 3e 5d  [, <constraint>]
2090: 2a 0a 29 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 64 65  *.).} {column-de
20a0: 66 7d 20 7b 0a 3c 6e 61 6d 65 3e 20 3c 74 79 70  f} {.<name> <typ
20b0: 65 3e 20 5b 3c 63 6f 6c 75 6d 6e 2d 63 6f 6e 73  e> [<column-cons
20c0: 74 72 61 69 6e 74 3e 5d 2a 0a 7d 20 7b 74 79 70  traint>]*.} {typ
20d0: 65 7d 20 7b 0a 3c 74 79 70 65 6e 61 6d 65 3e 20  e} {.<typename> 
20e0: 7c 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 28 20 3c  |.<typename> ( <
20f0: 6e 75 6d 62 65 72 3e 20 29 20 7c 0a 3c 74 79 70  number> ) |.<typ
2100: 65 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d 62 65 72  ename> ( <number
2110: 3e 20 2c 20 3c 6e 75 6d 62 65 72 3e 20 29 0a 7d  > , <number> ).}
2120: 20 7b 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61   {column-constra
2130: 69 6e 74 7d 20 7b 0a 4e 4f 54 20 4e 55 4c 4c 20  int} {.NOT NULL 
2140: 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  [ <conflict-clau
2150: 73 65 3e 20 5d 20 7c 0a 50 52 49 4d 41 52 59 20  se> ] |.PRIMARY 
2160: 4b 45 59 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72  KEY [<sort-order
2170: 3e 5d 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63  >] [ <conflict-c
2180: 6c 61 75 73 65 3e 20 5d 20 7c 0a 55 4e 49 51 55  lause> ] |.UNIQU
2190: 45 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  E [ <conflict-cl
21a0: 61 75 73 65 3e 20 5d 20 7c 0a 43 48 45 43 4b 20  ause> ] |.CHECK 
21b0: 28 20 3c 65 78 70 72 3e 20 29 20 5b 20 3c 63 6f  ( <expr> ) [ <co
21c0: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d  nflict-clause> ]
21d0: 20 7c 0a 44 45 46 41 55 4c 54 20 3c 76 61 6c 75   |.DEFAULT <valu
21e0: 65 3e 0a 7d 20 7b 63 6f 6e 73 74 72 61 69 6e 74  e>.} {constraint
21f0: 7d 20 7b 0a 50 52 49 4d 41 52 59 20 4b 45 59 20  } {.PRIMARY KEY 
2200: 28 20 3c 6e 61 6d 65 3e 20 5b 2c 20 3c 6e 61 6d  ( <name> [, <nam
2210: 65 3e 5d 2a 20 29 20 5b 20 3c 63 6f 6e 66 6c 69  e>]* ) [ <confli
2220: 63 74 2d 63 6c 61 75 73 65 3e 20 5d 7c 0a 55 4e  ct-clause> ]|.UN
2230: 49 51 55 45 20 28 20 3c 6e 61 6d 65 3e 20 5b 2c  IQUE ( <name> [,
2240: 20 3c 6e 61 6d 65 3e 5d 2a 20 29 20 5b 20 3c 63   <name>]* ) [ <c
2250: 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20  onflict-clause> 
2260: 5d 20 7c 0a 43 48 45 43 4b 20 28 20 3c 65 78 70  ] |.CHECK ( <exp
2270: 72 3e 20 29 20 5b 20 3c 63 6f 6e 66 6c 69 63 74  r> ) [ <conflict
2280: 2d 63 6c 61 75 73 65 3e 20 5d 0a 7d 20 7b 63 6f  -clause> ].} {co
2290: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 7d 20 7b  nflict-clause} {
22a0: 0a 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 63 6f  .ON CONFLICT <co
22b0: 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d  nflict-algorithm
22c0: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 41  >.}..puts {.<p>A
22d0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74   CREATE TABLE st
22e0: 61 74 65 6d 65 6e 74 20 69 73 20 62 61 73 69 63  atement is basic
22f0: 61 6c 6c 79 20 74 68 65 20 6b 65 79 77 6f 72 64  ally the keyword
2300: 73 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 22  s "CREATE TABLE"
2310: 0a 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68 65  .followed by the
2320: 20 6e 61 6d 65 20 6f 66 20 61 20 6e 65 77 20 74   name of a new t
2330: 61 62 6c 65 20 61 6e 64 20 61 20 70 61 72 65 6e  able and a paren
2340: 74 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f 66  thesized list of
2350: 20 63 6f 6c 75 6d 6e 0a 64 65 66 69 6e 69 74 69   column.definiti
2360: 6f 6e 73 20 61 6e 64 20 63 6f 6e 73 74 72 61 69  ons and constrai
2370: 6e 74 73 2e 20 20 54 68 65 20 74 61 62 6c 65 20  nts.  The table 
2380: 6e 61 6d 65 20 63 61 6e 20 62 65 20 65 69 74 68  name can be eith
2390: 65 72 20 61 6e 20 69 64 65 6e 74 69 66 69 65 72  er an identifier
23a0: 0a 6f 72 20 61 20 73 74 72 69 6e 67 2e 20 20 54  .or a string.  T
23b0: 68 65 20 6f 6e 6c 79 20 72 65 73 65 72 76 65 64  he only reserved
23c0: 20 74 61 62 6c 65 20 6e 61 6d 65 20 69 73 20 22   table name is "
23d0: 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  <b>sqlite_master
23e0: 3c 2f 62 3e 22 20 77 68 69 63 68 0a 69 73 20 74  </b>" which.is t
23f0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74  he name of the t
2400: 61 62 6c 65 20 74 68 61 74 20 72 65 63 6f 72 64  able that record
2410: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73  s the database s
2420: 63 68 65 6d 61 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45  chema.</p>..<p>E
2430: 61 63 68 20 63 6f 6c 75 6d 6e 20 64 65 66 69 6e  ach column defin
2440: 69 74 69 6f 6e 20 69 73 20 74 68 65 20 6e 61 6d  ition is the nam
2450: 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20  e of the column 
2460: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68 65 0a  followed by the.
2470: 64 61 74 61 74 79 70 65 20 66 6f 72 20 74 68 61  datatype for tha
2480: 74 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20 6f  t column, then o
2490: 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 70 74 69 6f  ne or more optio
24a0: 6e 61 6c 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73 74  nal column const
24b0: 72 61 69 6e 74 73 2e 0a 54 68 65 20 64 61 74 61  raints..The data
24c0: 74 79 70 65 20 66 6f 72 20 74 68 65 20 63 6f 6c  type for the col
24d0: 75 6d 6e 20 69 73 20 69 67 6e 6f 72 65 64 2e 20  umn is ignored. 
24e0: 20 41 6c 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e   All information
24f0: 0a 69 73 20 73 74 6f 72 65 64 20 61 73 20 6e 75  .is stored as nu
2500: 6c 6c 2d 74 65 72 6d 69 6e 61 74 65 64 20 73 74  ll-terminated st
2510: 72 69 6e 67 73 2e 0a 54 68 65 20 55 4e 49 51 55  rings..The UNIQU
2520: 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 61 75  E constraint cau
2530: 73 65 73 20 61 6e 20 69 6e 64 65 78 20 74 6f 20  ses an index to 
2540: 62 65 20 63 72 65 61 74 65 64 20 6f 6e 20 74 68  be created on th
2550: 65 20 73 70 65 63 69 66 69 65 64 0a 63 6f 6c 75  e specified.colu
2560: 6d 6e 73 2e 20 20 54 68 69 73 20 69 6e 64 65 78  mns.  This index
2570: 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 75 6e   must contain un
2580: 69 71 75 65 20 6b 65 79 73 2e 0a 54 68 65 20 44  ique keys..The D
2590: 45 46 41 55 4c 54 20 63 6f 6e 73 74 72 61 69 6e  EFAULT constrain
25a0: 74 0a 73 70 65 63 69 66 69 65 73 20 61 20 64 65  t.specifies a de
25b0: 66 61 75 6c 74 20 76 61 6c 75 65 20 74 6f 20 75  fault value to u
25c0: 73 65 20 77 68 65 6e 20 64 6f 69 6e 67 20 61 6e  se when doing an
25d0: 20 49 4e 53 45 52 54 2e 0a 3c 2f 70 3e 0a 0a 3c   INSERT..</p>..<
25e0: 70 3e 53 70 65 63 69 66 79 69 6e 67 20 61 20 50  p>Specifying a P
25f0: 52 49 4d 41 52 59 20 4b 45 59 20 6e 6f 72 6d 61  RIMARY KEY norma
2600: 6c 6c 79 20 6a 75 73 74 20 63 72 65 61 74 65 73  lly just creates
2610: 20 61 20 55 4e 49 51 55 45 20 69 6e 64 65 78 0a   a UNIQUE index.
2620: 6f 6e 20 74 68 65 20 70 72 69 6d 61 72 79 20 6b  on the primary k
2630: 65 79 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 66  ey.  However, if
2640: 20 70 72 69 6d 61 72 79 20 6b 65 79 20 69 73 20   primary key is 
2650: 6f 6e 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75  on a single colu
2660: 6d 6e 0a 74 68 61 74 20 68 61 73 20 64 61 74 61  mn.that has data
2670: 74 79 70 65 20 49 4e 54 45 47 45 52 2c 20 74 68  type INTEGER, th
2680: 65 6e 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20 69  en that column i
2690: 73 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c  s used internall
26a0: 79 0a 61 73 20 74 68 65 20 61 63 74 75 61 6c 20  y.as the actual 
26b0: 6b 65 79 20 6f 66 20 74 68 65 20 42 2d 54 72 65  key of the B-Tre
26c0: 65 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65 2e  e for the table.
26d0: 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61    This means tha
26e0: 74 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 6d 61 79  t the column.may
26f0: 20 6f 6e 6c 79 20 68 6f 6c 64 20 75 6e 69 71 75   only hold uniqu
2700: 65 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 73  e integer values
2710: 2e 20 20 28 45 78 63 65 70 74 20 66 6f 72 20 74  .  (Except for t
2720: 68 69 73 20 6f 6e 65 20 63 61 73 65 2c 0a 53 51  his one case,.SQ
2730: 4c 69 74 65 20 69 67 6e 6f 72 65 73 20 74 68 65  Lite ignores the
2740: 20 64 61 74 61 74 79 70 65 20 73 70 65 63 69 66   datatype specif
2750: 69 63 61 74 69 6f 6e 20 6f 66 20 63 6f 6c 75 6d  ication of colum
2760: 6e 73 20 61 6e 64 20 61 6c 6c 6f 77 73 0a 61 6e  ns and allows.an
2770: 79 20 6b 69 6e 64 20 6f 66 20 64 61 74 61 20 74  y kind of data t
2780: 6f 20 62 65 20 70 75 74 20 69 6e 20 61 20 63 6f  o be put in a co
2790: 6c 75 6d 6e 20 72 65 67 61 72 64 6c 65 73 73 20  lumn regardless 
27a0: 6f 66 20 69 74 73 20 64 65 63 6c 61 72 65 64 0a  of its declared.
27b0: 64 61 74 61 74 79 70 65 2e 29 20 20 49 66 20 61  datatype.)  If a
27c0: 20 74 61 62 6c 65 20 64 6f 65 73 20 6e 6f 74 20   table does not 
27d0: 68 61 76 65 20 61 6e 20 49 4e 54 45 47 45 52 20  have an INTEGER 
27e0: 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75  PRIMARY KEY colu
27f0: 6d 6e 2c 0a 74 68 65 6e 20 74 68 65 20 42 2d 54  mn,.then the B-T
2800: 72 65 65 20 6b 65 79 20 77 69 6c 6c 20 62 65 20  ree key will be 
2810: 61 20 72 61 6e 64 6f 6d 6c 79 20 67 65 6e 65 72  a randomly gener
2820: 61 74 65 64 20 69 6e 74 65 67 65 72 2e 20 20 54  ated integer.  T
2830: 68 65 0a 42 2d 54 72 65 65 20 6b 65 79 20 66 6f  he.B-Tree key fo
2840: 72 20 61 20 72 6f 77 20 63 61 6e 20 61 6c 77 61  r a row can alwa
2850: 79 73 20 62 65 20 61 63 63 65 73 73 65 64 20 75  ys be accessed u
2860: 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 0a  sing one of the.
2870: 73 70 65 63 69 61 6c 20 6e 61 6d 65 73 20 22 3c  special names "<
2880: 62 3e 52 4f 57 49 44 3c 2f 62 3e 22 2c 20 22 3c  b>ROWID</b>", "<
2890: 62 3e 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20 22  b>OID</b>", or "
28a0: 3c 62 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22 2e  <b>_ROWID_</b>".
28b0: 0a 54 68 69 73 20 69 73 20 74 72 75 65 20 72 65  .This is true re
28c0: 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74  gardless of whet
28d0: 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 72 65  her or not there
28e0: 20 69 73 20 61 6e 20 49 4e 54 45 47 45 52 0a 50   is an INTEGER.P
28f0: 52 49 4d 41 52 59 20 4b 45 59 2e 3c 2f 70 3e 0a  RIMARY KEY.</p>.
2900: 0a 3c 70 3e 49 66 20 74 68 65 20 22 54 45 4d 50  .<p>If the "TEMP
2910: 22 20 6f 72 20 22 54 45 4d 50 4f 52 41 52 59 22  " or "TEMPORARY"
2920: 20 6b 65 79 77 6f 72 64 20 6f 63 63 75 72 73 20   keyword occurs 
2930: 69 6e 20 62 65 74 77 65 65 6e 20 22 43 52 45 41  in between "CREA
2940: 54 45 22 0a 61 6e 64 20 22 54 41 42 4c 45 22 20  TE".and "TABLE" 
2950: 74 68 65 6e 20 74 68 65 20 74 61 62 6c 65 20 74  then the table t
2960: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 69  hat is created i
2970: 73 20 6f 6e 6c 79 20 76 69 73 69 62 6c 65 20 74  s only visible t
2980: 6f 20 74 68 65 0a 70 72 6f 63 65 73 73 20 74 68  o the.process th
2990: 61 74 20 6f 70 65 6e 65 64 20 74 68 65 20 64 61  at opened the da
29a0: 74 61 62 61 73 65 20 61 6e 64 20 69 73 20 61 75  tabase and is au
29b0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65  tomatically dele
29c0: 74 65 64 20 77 68 65 6e 0a 74 68 65 20 64 61 74  ted when.the dat
29d0: 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 2e  abase is closed.
29e0: 20 20 41 6e 79 20 69 6e 64 69 63 65 73 20 63 72    Any indices cr
29f0: 65 61 74 65 64 20 6f 6e 20 61 20 74 65 6d 70 6f  eated on a tempo
2a00: 72 61 72 79 20 74 61 62 6c 65 0a 61 72 65 20 61  rary table.are a
2a10: 6c 73 6f 20 74 65 6d 70 6f 72 61 72 79 2e 20 20  lso temporary.  
2a20: 54 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 73  Temporary tables
2a30: 20 61 6e 64 20 69 6e 64 69 63 65 73 20 61 72 65   and indices are
2a40: 20 73 74 6f 72 65 64 20 69 6e 20 61 0a 73 65 70   stored in a.sep
2a50: 61 72 61 74 65 20 66 69 6c 65 20 64 69 73 74 69  arate file disti
2a60: 6e 63 74 20 66 72 6f 6d 20 74 68 65 20 6d 61 69  nct from the mai
2a70: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  n database file.
2a80: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74  </p>..<p>The opt
2a90: 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63  ional conflict-c
2aa0: 6c 61 75 73 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  lause following 
2ab0: 65 61 63 68 20 63 6f 6e 73 74 72 61 69 6e 74 0a  each constraint.
2ac0: 61 6c 6c 6f 77 73 20 74 68 65 20 73 70 65 63 69  allows the speci
2ad0: 66 69 63 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61  fication of an a
2ae0: 6c 74 65 72 6e 61 74 69 76 65 20 64 65 66 61 75  lternative defau
2af0: 6c 74 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f  lt.constraint co
2b00: 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f  nflict resolutio
2b10: 6e 20 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20  n algorithm for 
2b20: 74 68 61 74 20 63 6f 6e 73 74 72 61 69 6e 74 2e  that constraint.
2b30: 0a 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20  .The default is 
2b40: 61 62 6f 72 74 20 41 42 4f 52 54 2e 20 20 44 69  abort ABORT.  Di
2b50: 66 66 65 72 65 6e 74 20 63 6f 6e 73 74 72 61 69  fferent constrai
2b60: 6e 74 73 20 77 69 74 68 69 6e 20 74 68 65 20 73  nts within the s
2b70: 61 6d 65 0a 74 61 62 6c 65 20 6d 61 79 20 68 61  ame.table may ha
2b80: 76 65 20 64 69 66 66 65 72 65 6e 74 20 64 65 66  ve different def
2b90: 61 75 6c 74 20 63 6f 6e 66 6c 69 63 74 20 72 65  ault conflict re
2ba0: 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74  solution algorit
2bb0: 68 6d 73 2e 0a 49 66 20 61 6e 20 43 4f 50 59 2c  hms..If an COPY,
2bc0: 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41   INSERT, or UPDA
2bd0: 54 45 20 63 6f 6d 6d 61 6e 64 20 73 70 65 63 69  TE command speci
2be0: 66 69 65 73 20 61 20 64 69 66 66 65 72 65 6e 74  fies a different
2bf0: 20 63 6f 6e 66 6c 69 63 74 0a 72 65 73 6f 6c 75   conflict.resolu
2c00: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2c 20  tion algorithm, 
2c10: 74 68 65 6e 20 74 68 61 74 20 61 6c 67 6f 72 69  then that algori
2c20: 74 68 6d 20 69 73 20 75 73 65 64 20 69 6e 20 70  thm is used in p
2c30: 6c 61 63 65 20 6f 66 20 74 68 65 0a 64 65 66 61  lace of the.defa
2c40: 75 6c 74 20 61 6c 67 6f 72 69 74 68 6d 20 73 70  ult algorithm sp
2c50: 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 43  ecified in the C
2c60: 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61 74  REATE TABLE stat
2c70: 65 6d 65 6e 74 2e 0a 53 65 65 20 74 68 65 20 73  ement..See the s
2c80: 65 63 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61  ection titled.<a
2c90: 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74   href="#conflict
2ca0: 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61  ">ON CONFLICT</a
2cb0: 3e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  > for additional
2cc0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70   information.</p
2cd0: 3e 0a 0a 3c 70 3e 43 48 45 43 4b 20 63 6f 6e 73  >..<p>CHECK cons
2ce0: 74 72 61 69 6e 74 73 20 61 72 65 20 69 67 6e 6f  traints are igno
2cf0: 72 65 64 20 69 6e 20 74 68 65 20 63 75 72 72 65  red in the curre
2d00: 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  nt implementatio
2d10: 6e 2e 0a 53 75 70 70 6f 72 74 20 66 6f 72 20 43  n..Support for C
2d20: 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73  HECK constraints
2d30: 20 6d 61 79 20 62 65 20 61 64 64 65 64 20 69 6e   may be added in
2d40: 20 74 68 65 20 66 75 74 75 72 65 2e 20 20 41 73   the future.  As
2d50: 20 6f 66 0a 76 65 72 73 69 6f 6e 20 32 2e 33 2e   of.version 2.3.
2d60: 30 2c 20 4e 4f 54 20 4e 55 4c 4c 2c 20 50 52 49  0, NOT NULL, PRI
2d70: 4d 41 52 59 20 4b 45 59 2c 20 61 6e 64 20 55 4e  MARY KEY, and UN
2d80: 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 73  IQUE constraints
2d90: 20 61 6c 6c 0a 77 6f 72 6b 2e 3c 2f 70 3e 0a 0a   all.work.</p>..
2da0: 3c 70 3e 54 68 65 72 65 20 61 72 65 20 6e 6f 20  <p>There are no 
2db0: 61 72 62 69 74 72 61 72 79 20 6c 69 6d 69 74 73  arbitrary limits
2dc0: 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 0a 6f   on the number.o
2dd0: 66 20 63 6f 6c 75 6d 6e 73 20 6f 72 20 6f 6e 20  f columns or on 
2de0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  the number of co
2df0: 6e 73 74 72 61 69 6e 74 73 20 69 6e 20 61 20 74  nstraints in a t
2e00: 61 62 6c 65 2e 0a 54 68 65 20 74 6f 74 61 6c 20  able..The total 
2e10: 61 6d 6f 75 6e 74 20 6f 66 20 64 61 74 61 20 69  amount of data i
2e20: 6e 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 69  n a single row i
2e30: 73 20 6c 69 6d 69 74 65 64 20 74 6f 20 61 62 6f  s limited to abo
2e40: 75 74 0a 31 20 6d 65 67 61 62 79 74 65 73 2e 20  ut.1 megabytes. 
2e50: 20 28 54 68 69 73 20 6c 69 6d 69 74 20 63 61 6e   (This limit can
2e60: 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 74 6f   be increased to
2e70: 20 31 36 4d 42 20 62 79 20 63 68 61 6e 67 69 6e   16MB by changin
2e80: 67 0a 61 20 73 69 6e 67 6c 65 20 23 64 65 66 69  g.a single #defi
2e90: 6e 65 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65  ne in the source
2ea0: 20 63 6f 64 65 20 61 6e 64 20 72 65 63 6f 6d 70   code and recomp
2eb0: 69 6c 69 6e 67 2e 29 3c 2f 70 3e 0a 0a 3c 70 3e  iling.)</p>..<p>
2ec0: 54 68 65 20 65 78 61 63 74 20 74 65 78 74 0a 6f  The exact text.o
2ed0: 66 20 65 61 63 68 20 43 52 45 41 54 45 20 54 41  f each CREATE TA
2ee0: 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 20 69 73  BLE statement is
2ef0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 3c   stored in the <
2f00: 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c  b>sqlite_master<
2f10: 2f 62 3e 0a 74 61 62 6c 65 2e 20 20 45 76 65 72  /b>.table.  Ever
2f20: 79 74 69 6d 65 20 74 68 65 20 64 61 74 61 62 61  ytime the databa
2f30: 73 65 20 69 73 20 6f 70 65 6e 65 64 2c 20 61 6c  se is opened, al
2f40: 6c 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73  l CREATE TABLE s
2f50: 74 61 74 65 6d 65 6e 74 73 0a 61 72 65 20 72 65  tatements.are re
2f60: 61 64 20 66 72 6f 6d 20 74 68 65 20 3c 62 3e 73  ad from the <b>s
2f70: 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e  qlite_master</b>
2f80: 20 74 61 62 6c 65 20 61 6e 64 20 75 73 65 64 20   table and used 
2f90: 74 6f 20 72 65 67 65 6e 65 72 61 74 65 0a 53 51  to regenerate.SQ
2fa0: 4c 69 74 65 27 73 20 69 6e 74 65 72 6e 61 6c 20  Lite's internal 
2fb0: 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f  representation o
2fc0: 66 20 74 68 65 20 74 61 62 6c 65 20 6c 61 79 6f  f the table layo
2fd0: 75 74 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69  ut.</p>.}..Secti
2fe0: 6f 6e 20 44 45 4c 45 54 45 20 64 65 6c 65 74 65  on DELETE delete
2ff0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
3000: 61 74 65 6d 65 6e 74 7d 20 7b 0a 44 45 4c 45 54  atement} {.DELET
3010: 45 20 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6e 61  E FROM <table-na
3020: 6d 65 3e 20 5b 57 48 45 52 45 20 3c 65 78 70 72  me> [WHERE <expr
3030: 65 73 73 69 6f 6e 3e 5d 0a 7d 0a 0a 70 75 74 73  ession>].}..puts
3040: 20 7b 0a 3c 70 3e 54 68 65 20 44 45 4c 45 54 45   {.<p>The DELETE
3050: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 75 73 65 64   command is used
3060: 20 74 6f 20 72 65 6d 6f 76 65 20 72 65 63 6f 72   to remove recor
3070: 64 73 20 66 72 6f 6d 20 61 20 74 61 62 6c 65 2e  ds from a table.
3080: 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e  .The command con
3090: 73 69 73 74 73 20 6f 66 20 74 68 65 20 22 44 45  sists of the "DE
30a0: 4c 45 54 45 20 46 52 4f 4d 22 20 6b 65 79 77 6f  LETE FROM" keywo
30b0: 72 64 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 0a  rds followed by.
30c0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
30d0: 74 61 62 6c 65 20 66 72 6f 6d 20 77 68 69 63 68  table from which
30e0: 20 72 65 63 6f 72 64 73 20 61 72 65 20 74 6f 20   records are to 
30f0: 62 65 20 72 65 6d 6f 76 65 64 2e 0a 3c 2f 70 3e  be removed..</p>
3100: 0a 0a 3c 70 3e 57 69 74 68 6f 75 74 20 61 20 57  ..<p>Without a W
3110: 48 45 52 45 20 63 6c 61 75 73 65 2c 20 61 6c 6c  HERE clause, all
3120: 20 72 6f 77 73 20 6f 66 20 74 68 65 20 74 61 62   rows of the tab
3130: 6c 65 20 61 72 65 20 72 65 6d 6f 76 65 64 2e 0a  le are removed..
3140: 49 66 20 61 20 57 48 45 52 45 20 63 6c 61 75 73  If a WHERE claus
3150: 65 20 69 73 20 73 75 70 70 6c 69 65 64 2c 20 74  e is supplied, t
3160: 68 65 6e 20 6f 6e 6c 79 20 74 68 6f 73 65 20 72  hen only those r
3170: 6f 77 73 20 74 68 61 74 20 6d 61 74 63 68 0a 74  ows that match.t
3180: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 61 72  he expression ar
3190: 65 20 72 65 6d 6f 76 65 64 2e 3c 2f 70 3e 0a 7d  e removed.</p>.}
31a0: 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50  ...Section {DROP
31b0: 20 49 4e 44 45 58 7d 20 64 72 6f 70 69 6e 64 65   INDEX} dropinde
31c0: 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63  x..Syntax {sql-c
31d0: 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 49  ommand} {.DROP I
31e0: 4e 44 45 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65  NDEX <index-name
31f0: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  >.}..puts {.<p>T
3200: 68 65 20 44 52 4f 50 20 49 4e 44 45 58 20 73 74  he DROP INDEX st
3210: 61 74 65 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73  atement consists
3220: 20 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73   of the keywords
3230: 20 22 44 52 4f 50 20 49 4e 44 45 58 22 20 66 6f   "DROP INDEX" fo
3240: 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e 61  llowed.by the na
3250: 6d 65 20 6f 66 20 74 68 65 20 69 6e 64 65 78 2e  me of the index.
3260: 20 20 54 68 65 20 69 6e 64 65 78 20 6e 61 6d 65    The index name
3270: 64 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20  d is completely 
3280: 72 65 6d 6f 76 65 64 20 66 72 6f 6d 0a 74 68 65  removed from.the
3290: 20 64 69 73 6b 2e 20 20 54 68 65 20 6f 6e 6c 79   disk.  The only
32a0: 20 77 61 79 20 74 6f 20 72 65 63 6f 76 65 72 20   way to recover 
32b0: 74 68 65 20 69 6e 64 65 78 20 69 73 20 74 6f 20  the index is to 
32c0: 72 65 65 6e 74 65 72 20 74 68 65 0a 61 70 70 72  reenter the.appr
32d0: 6f 70 72 69 61 74 65 20 43 52 45 41 54 45 20 49  opriate CREATE I
32e0: 4e 44 45 58 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70  NDEX command.</p
32f0: 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52  >.}..Section {DR
3300: 4f 50 20 54 41 42 4c 45 7d 20 64 72 6f 70 74 61  OP TABLE} dropta
3310: 62 6c 65 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  ble..Syntax {sql
3320: 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50  -command} {.DROP
3330: 20 54 41 42 4c 45 20 3c 74 61 62 6c 65 2d 6e 61   TABLE <table-na
3340: 6d 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  me>.}..puts {.<p
3350: 3e 54 68 65 20 44 52 4f 50 20 54 41 42 4c 45 20  >The DROP TABLE 
3360: 73 74 61 74 65 6d 65 6e 74 20 63 6f 6e 73 69 73  statement consis
3370: 74 73 20 6f 66 20 74 68 65 20 6b 65 79 77 6f 72  ts of the keywor
3380: 64 73 20 22 44 52 4f 50 20 54 41 42 4c 45 22 20  ds "DROP TABLE" 
3390: 66 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20  followed.by the 
33a0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
33b0: 65 2e 20 20 54 68 65 20 74 61 62 6c 65 20 6e 61  e.  The table na
33c0: 6d 65 64 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c  med is completel
33d0: 79 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 0a 74  y removed from.t
33e0: 68 65 20 64 69 73 6b 2e 20 20 54 68 65 20 74 61  he disk.  The ta
33f0: 62 6c 65 20 63 61 6e 20 6e 6f 74 20 62 65 20 72  ble can not be r
3400: 65 63 6f 76 65 72 65 64 2e 20 20 41 6c 6c 20 69  ecovered.  All i
3410: 6e 64 69 63 65 73 20 61 73 73 6f 63 69 61 74 65  ndices associate
3420: 64 20 77 69 74 68 0a 74 68 65 20 74 61 62 6c 65  d with.the table
3430: 20 61 72 65 20 61 6c 73 6f 20 64 65 6c 65 74 65   are also delete
3440: 64 2e 3c 2f 70 3e 7d 0a 0a 53 65 63 74 69 6f 6e  d.</p>}..Section
3450: 20 45 58 50 4c 41 49 4e 20 65 78 70 6c 61 69 6e   EXPLAIN explain
3460: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
3470: 61 74 65 6d 65 6e 74 7d 20 7b 0a 45 58 50 4c 41  atement} {.EXPLA
3480: 49 4e 20 3c 73 71 6c 2d 73 74 61 74 65 6d 65 6e  IN <sql-statemen
3490: 74 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  t>.}..puts {.<p>
34a0: 54 68 65 20 45 58 50 4c 41 49 4e 20 63 6f 6d 6d  The EXPLAIN comm
34b0: 61 6e 64 20 6d 6f 64 69 66 69 65 72 20 69 73 20  and modifier is 
34c0: 61 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 64 20 65  a non-standard e
34d0: 78 74 65 6e 73 69 6f 6e 2e 20 20 54 68 65 0a 69  xtension.  The.i
34e0: 64 65 61 20 63 6f 6d 65 73 20 66 72 6f 6d 20 61  dea comes from a
34f0: 20 73 69 6d 69 6c 61 72 20 63 6f 6d 6d 61 6e 64   similar command
3500: 20 66 6f 75 6e 64 20 69 6e 20 50 6f 73 74 67 72   found in Postgr
3510: 65 53 51 4c 2c 20 62 75 74 20 74 68 65 20 6f 70  eSQL, but the op
3520: 65 72 61 74 69 6f 6e 0a 69 73 20 63 6f 6d 70 6c  eration.is compl
3530: 65 74 65 6c 79 20 64 69 66 66 65 72 65 6e 74 2e  etely different.
3540: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20  </p>..<p>If the 
3550: 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 20  EXPLAIN keyword 
3560: 61 70 70 65 61 72 73 20 62 65 66 6f 72 65 20 61  appears before a
3570: 6e 79 20 6f 74 68 65 72 20 53 51 4c 69 74 65 20  ny other SQLite 
3580: 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 74 68 65 6e  SQL command.then
3590: 20 69 6e 73 74 65 61 64 20 6f 66 20 61 63 74 75   instead of actu
35a0: 61 6c 6c 79 20 65 78 65 63 75 74 69 6e 67 20 74  ally executing t
35b0: 68 65 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65 20  he command, the 
35c0: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 77  SQLite library w
35d0: 69 6c 6c 0a 72 65 70 6f 72 74 20 62 61 63 6b 20  ill.report back 
35e0: 74 68 65 20 73 65 71 75 65 6e 63 65 20 6f 66 20  the sequence of 
35f0: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
3600: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 74 20  instructions it 
3610: 77 6f 75 6c 64 20 68 61 76 65 0a 75 73 65 64 20  would have.used 
3620: 74 6f 20 65 78 65 63 75 74 65 20 74 68 65 20 63  to execute the c
3630: 6f 6d 6d 61 6e 64 20 68 61 64 20 74 68 65 20 45  ommand had the E
3640: 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 20 6e  XPLAIN keyword n
3650: 6f 74 20 62 65 65 6e 20 70 72 65 73 65 6e 74 2e  ot been present.
3660: 0a 46 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20  .For additional 
3670: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75  information abou
3680: 74 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e  t virtual machin
3690: 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 73  e instructions s
36a0: 65 65 0a 74 68 65 20 3c 61 20 68 72 65 66 3d 22  ee.the <a href="
36b0: 61 72 63 68 2e 68 74 6d 6c 22 3e 61 72 63 68 69  arch.html">archi
36c0: 74 65 63 74 75 72 65 20 64 65 73 63 72 69 70 74  tecture descript
36d0: 69 6f 6e 3c 2f 61 3e 20 6f 72 20 74 68 65 20 64  ion</a> or the d
36e0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0a 6f 6e 20  ocumentation.on 
36f0: 3c 61 20 68 72 65 66 3d 22 6f 70 63 6f 64 65 2e  <a href="opcode.
3700: 68 74 6d 6c 22 3e 61 76 61 69 6c 61 62 6c 65 20  html">available 
3710: 6f 70 63 6f 64 65 73 3c 2f 61 3e 20 66 6f 72 20  opcodes</a> for 
3720: 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68  the virtual mach
3730: 69 6e 65 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74  ine.</p>.}..Sect
3740: 69 6f 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 65  ion expression e
3750: 78 70 72 0a 0a 53 79 6e 74 61 78 20 7b 65 78 70  xpr..Syntax {exp
3760: 72 65 73 73 69 6f 6e 7d 20 7b 0a 3c 65 78 70 72  ression} {.<expr
3770: 65 73 73 69 6f 6e 3e 20 3c 62 69 6e 61 72 79 2d  ession> <binary-
3780: 6f 70 3e 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e  op> <expression>
3790: 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20   |.<expression> 
37a0: 3c 6c 69 6b 65 2d 6f 70 3e 20 3c 65 78 70 72 65  <like-op> <expre
37b0: 73 73 69 6f 6e 3e 20 7c 0a 3c 75 6e 61 72 79 2d  ssion> |.<unary-
37c0: 6f 70 3e 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e  op> <expression>
37d0: 20 7c 0a 28 20 3c 65 78 70 72 65 73 73 69 6f 6e   |.( <expression
37e0: 3e 20 29 20 7c 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61  > ) |.<column-na
37f0: 6d 65 3e 20 7c 0a 3c 74 61 62 6c 65 2d 6e 61 6d  me> |.<table-nam
3800: 65 3e 20 2e 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d  e> . <column-nam
3810: 65 3e 20 7c 0a 3c 6c 69 74 65 72 61 6c 2d 76 61  e> |.<literal-va
3820: 6c 75 65 3e 20 7c 0a 3c 66 75 6e 63 74 69 6f 6e  lue> |.<function
3830: 2d 6e 61 6d 65 3e 20 28 20 3c 65 78 70 72 2d 6c  -name> ( <expr-l
3840: 69 73 74 3e 20 7c 20 53 54 41 52 20 29 20 7c 0a  ist> | STAR ) |.
3850: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 49 53 4e  <expression> ISN
3860: 55 4c 4c 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f  ULL |.<expressio
3870: 6e 3e 20 4e 4f 54 4e 55 4c 4c 20 7c 0a 3c 65 78  n> NOTNULL |.<ex
3880: 70 72 65 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d 20  pression> [NOT] 
3890: 42 45 54 57 45 45 4e 20 3c 65 78 70 72 65 73 73  BETWEEN <express
38a0: 69 6f 6e 3e 20 41 4e 44 20 3c 65 78 70 72 65 73  ion> AND <expres
38b0: 73 69 6f 6e 3e 20 7c 0a 3c 65 78 70 72 65 73 73  sion> |.<express
38c0: 69 6f 6e 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28 20  ion> [NOT] IN ( 
38d0: 3c 76 61 6c 75 65 2d 6c 69 73 74 3e 20 29 20 7c  <value-list> ) |
38e0: 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 5b 4e  .<expression> [N
38f0: 4f 54 5d 20 49 4e 20 28 20 3c 73 65 6c 65 63 74  OT] IN ( <select
3900: 3e 20 29 20 7c 0a 28 20 3c 73 65 6c 65 63 74 3e  > ) |.( <select>
3910: 20 29 0a 7d 20 7b 6c 69 6b 65 2d 6f 70 7d 20 7b   ).} {like-op} {
3920: 0a 4c 49 4b 45 20 7c 20 47 4c 4f 42 20 7c 20 4e  .LIKE | GLOB | N
3930: 4f 54 20 4c 49 4b 45 20 7c 20 4e 4f 54 20 47 4c  OT LIKE | NOT GL
3940: 4f 42 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  OB.}..puts {.<p>
3950: 54 68 69 73 20 73 65 63 74 69 6f 6e 20 69 73 20  This section is 
3960: 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74  different from t
3970: 68 65 20 6f 74 68 65 72 73 2e 20 20 4d 6f 73 74  he others.  Most
3980: 20 6f 74 68 65 72 20 73 65 63 74 69 6f 6e 73 20   other sections 
3990: 6f 66 0a 74 68 69 73 20 64 6f 63 75 6d 65 6e 74  of.this document
39a0: 20 74 61 6c 6b 73 20 61 62 6f 75 74 20 61 20 70   talks about a p
39b0: 61 72 74 69 63 75 6c 61 72 20 53 51 4c 20 63 6f  articular SQL co
39c0: 6d 6d 61 6e 64 2e 20 20 54 68 69 73 20 73 65 63  mmand.  This sec
39d0: 74 69 6f 6e 20 64 6f 65 73 0a 6e 6f 74 20 74 61  tion does.not ta
39e0: 6c 6b 20 61 62 6f 75 74 20 61 20 73 74 61 6e 64  lk about a stand
39f0: 61 6c 6f 6e 65 20 63 6f 6d 6d 61 6e 64 20 62 75  alone command bu
3a00: 74 20 61 62 6f 75 74 20 22 65 78 70 72 65 73 73  t about "express
3a10: 69 6f 6e 73 22 20 77 68 69 63 68 20 61 72 65 20  ions" which are 
3a20: 0a 73 75 62 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66  .subcomponent of
3a30: 20 6d 6f 73 74 20 6f 74 68 65 72 20 63 6f 6d 6d   most other comm
3a40: 61 6e 64 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51  ands.</p>..<p>SQ
3a50: 4c 69 74 65 20 75 6e 64 65 72 73 74 61 6e 64 73  Lite understands
3a60: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62   the following b
3a70: 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 73 2c  inary operators,
3a80: 20 69 6e 20 6f 72 64 65 72 20 66 72 6f 6d 0a 68   in order from.h
3a90: 69 67 68 65 73 74 20 74 6f 20 6c 6f 77 65 73 74  ighest to lowest
3aa0: 20 70 72 65 63 65 64 65 6e 63 65 3a 3c 2f 70 3e   precedence:</p>
3ab0: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70  ..<blockquote><p
3ac0: 72 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d  re>.<font color=
3ad0: 22 23 32 63 32 63 66 30 22 3e 3c 62 69 67 3e 2a  "#2c2cf0"><big>*
3ae0: 20 20 20 20 2f 20 20 20 20 25 0a 2b 20 20 20 20      /    %.+    
3af0: 2d 0a 26 6c 74 3b 26 6c 74 3b 20 20 20 26 67 74  -.&lt;&lt;   &gt
3b00: 3b 26 67 74 3b 20 20 20 26 61 6d 70 3b 20 20 20  ;&gt;   &amp;   
3b10: 20 7c 0a 26 6c 74 3b 20 20 20 20 26 6c 74 3b 3d   |.&lt;    &lt;=
3b20: 20 20 20 26 67 74 3b 20 20 20 20 26 67 74 3b 3d     &gt;    &gt;=
3b30: 0a 3d 20 20 20 20 3d 3d 20 20 20 21 3d 20 20 20  .=    ==   !=   
3b40: 26 6c 74 3b 26 67 74 3b 20 20 20 3c 2f 62 69 67  &lt;&gt;   </big
3b50: 3e 49 4e 0a 41 4e 44 0a 4f 52 3c 2f 66 6f 6e 74  >IN.AND.OR</font
3b60: 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71  >.</pre></blockq
3b70: 75 6f 74 65 3e 0a 0a 3c 70 3e 53 75 70 70 6f 72  uote>..<p>Suppor
3b80: 74 65 64 20 75 6e 61 72 79 20 6f 70 65 72 61 74  ted unary operat
3b90: 65 72 73 20 61 72 65 20 74 68 65 73 65 3a 3c 2f  ers are these:</
3ba0: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  p>..<blockquote>
3bb0: 3c 70 72 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f  <pre>.<font colo
3bc0: 72 3d 22 23 32 63 32 63 66 30 22 3e 3c 62 69 67  r="#2c2cf0"><big
3bd0: 3e 2d 20 20 20 20 2b 20 20 20 20 21 20 20 20 20  >-    +    !    
3be0: 7e 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74 3e 0a 3c  ~</big></font>.<
3bf0: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
3c00: 65 3e 0a 0a 3c 70 3e 41 6e 79 20 53 51 4c 69 74  e>..<p>Any SQLit
3c10: 65 20 76 61 6c 75 65 20 63 61 6e 20 62 65 20 75  e value can be u
3c20: 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 61  sed as part of a
3c30: 6e 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 0a  n expression.  .
3c40: 46 6f 72 20 61 72 69 74 68 6d 65 74 69 63 20 6f  For arithmetic o
3c50: 70 65 72 61 74 69 6f 6e 73 2c 20 69 6e 74 65 67  perations, integ
3c60: 65 72 73 20 61 72 65 20 74 72 65 61 74 65 64 20  ers are treated 
3c70: 61 73 20 69 6e 74 65 67 65 72 73 2e 0a 53 74 72  as integers..Str
3c80: 69 6e 67 73 20 61 72 65 20 66 69 72 73 74 20 63  ings are first c
3c90: 6f 6e 76 65 72 74 65 64 20 74 6f 20 72 65 61 6c  onverted to real
3ca0: 20 6e 75 6d 62 65 72 73 20 75 73 69 6e 67 20 3c   numbers using <
3cb0: 62 3e 61 74 6f 66 28 29 3c 2f 62 3e 2e 0a 46 6f  b>atof()</b>..Fo
3cc0: 72 20 63 6f 6d 70 61 72 69 73 6f 6e 20 6f 70 65  r comparison ope
3cd0: 72 61 74 6f 72 73 2c 20 6e 75 6d 62 65 72 73 20  rators, numbers 
3ce0: 63 6f 6d 70 61 72 65 20 61 73 20 6e 75 6d 62 65  compare as numbe
3cf0: 72 73 20 61 6e 64 20 73 74 72 69 6e 67 73 0a 63  rs and strings.c
3d00: 6f 6d 70 61 72 65 20 61 73 20 73 74 72 69 6e 67  ompare as string
3d10: 73 2e 20 20 46 6f 72 20 73 74 72 69 6e 67 20 63  s.  For string c
3d20: 6f 6d 70 61 72 69 73 6f 6e 73 2c 20 63 61 73 65  omparisons, case
3d30: 20 69 73 20 73 69 67 6e 69 66 69 63 61 6e 74 0a   is significant.
3d40: 62 75 74 20 69 73 20 6f 6e 6c 79 20 75 73 65 64  but is only used
3d50: 20 74 6f 20 62 72 65 61 6b 20 61 20 74 69 65 2e   to break a tie.
3d60: 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 65 72 65  .Note that there
3d70: 20 61 72 65 20 74 77 6f 20 76 61 72 69 61 74 69   are two variati
3d80: 6f 6e 73 20 6f 66 20 74 68 65 20 65 71 75 61 6c  ons of the equal
3d90: 73 20 61 6e 64 20 6e 6f 74 20 65 71 75 61 6c 73  s and not equals
3da0: 0a 6f 70 65 72 61 74 6f 72 73 2e 20 20 45 71 75  .operators.  Equ
3db0: 61 6c 73 20 63 61 6e 20 62 65 20 65 69 74 68 65  als can be eithe
3dc0: 72 7d 0a 70 75 74 73 20 22 5b 4f 70 65 72 61 74  r}.puts "[Operat
3dd0: 6f 72 20 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74  or =] or [Operat
3de0: 6f 72 20 3d 3d 5d 2e 0a 54 68 65 20 6e 6f 6e 2d  or ==]..The non-
3df0: 65 71 75 61 6c 73 20 6f 70 65 72 61 74 6f 72 20  equals operator 
3e00: 63 61 6e 20 62 65 20 65 69 74 68 65 72 0a 5b 4f  can be either.[O
3e10: 70 65 72 61 74 6f 72 20 21 3d 5d 20 6f 72 20 5b  perator !=] or [
3e20: 4f 70 65 72 61 74 6f 72 20 7b 26 6c 74 3b 26 67  Operator {&lt;&g
3e30: 74 3b 7d 5d 2e 3c 2f 70 3e 22 0a 70 75 74 73 20  t;}].</p>".puts 
3e40: 7b 0a 0a 3c 70 3e 54 68 65 20 4c 49 4b 45 20 6f  {..<p>The LIKE o
3e50: 70 65 72 61 74 6f 72 20 64 6f 65 73 20 61 20 77  perator does a w
3e60: 69 6c 64 63 61 72 64 20 63 6f 6d 70 61 72 69 73  ildcard comparis
3e70: 69 6f 6e 2e 20 20 54 68 65 20 6f 70 65 72 61 6e  ion.  The operan
3e80: 64 0a 74 6f 20 74 68 65 20 72 69 67 68 74 20 63  d.to the right c
3e90: 6f 6e 74 61 69 6e 73 20 74 68 65 20 77 69 6c 64  ontains the wild
3ea0: 63 61 72 64 73 2e 7d 0a 70 75 74 73 20 22 41 20  cards.}.puts "A 
3eb0: 70 65 72 63 65 6e 74 20 73 79 6d 62 6f 6c 20 5b  percent symbol [
3ec0: 4f 70 65 72 61 74 6f 72 20 25 5d 20 69 6e 20 74  Operator %] in t
3ed0: 68 65 20 72 69 67 68 74 20 6f 70 65 72 61 6e 64  he right operand
3ee0: 0a 6d 61 74 63 68 65 73 20 61 6e 79 20 73 65 71  .matches any seq
3ef0: 75 65 6e 63 65 20 6f 66 20 7a 65 72 6f 20 6f 72  uence of zero or
3f00: 20 6d 6f 72 65 20 63 68 61 72 61 63 74 65 72 73   more characters
3f10: 20 6f 6e 20 74 68 65 20 6c 65 66 74 2e 0a 41 6e   on the left..An
3f20: 20 75 6e 64 65 72 73 63 6f 72 65 20 5b 4f 70 65   underscore [Ope
3f30: 72 61 74 6f 72 20 5f 5d 20 6f 6e 20 74 68 65 20  rator _] on the 
3f40: 72 69 67 68 74 0a 6d 61 74 63 68 65 73 20 61 6e  right.matches an
3f50: 79 20 73 69 6e 67 6c 65 20 63 68 61 72 61 63 74  y single charact
3f60: 65 72 20 6f 6e 20 74 68 65 20 6c 65 66 74 2e 22  er on the left."
3f70: 0a 70 75 74 73 20 7b 54 68 65 20 4c 49 4b 45 20  .puts {The LIKE 
3f80: 6f 70 65 72 61 74 6f 72 20 69 73 0a 6e 6f 74 20  operator is.not 
3f90: 63 61 73 65 20 73 65 6e 73 69 74 69 76 65 20 61  case sensitive a
3fa0: 6e 64 20 77 69 6c 6c 20 6d 61 74 63 68 20 75 70  nd will match up
3fb0: 70 65 72 20 63 61 73 65 20 63 68 61 72 61 63 74  per case charact
3fc0: 65 72 73 20 6f 6e 20 6f 6e 65 0a 73 69 64 65 20  ers on one.side 
3fd0: 61 67 61 69 6e 73 74 20 6c 6f 77 65 72 20 63 61  against lower ca
3fe0: 73 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e  se characters on
3ff0: 20 74 68 65 20 6f 74 68 65 72 2e 0a 28 41 20 62   the other..(A b
4000: 75 67 3a 20 53 51 4c 69 74 65 20 6f 6e 6c 79 20  ug: SQLite only 
4010: 75 6e 64 65 72 73 74 61 6e 64 73 20 75 70 70 65  understands uppe
4020: 72 2f 6c 6f 77 65 72 20 63 61 73 65 20 66 6f 72  r/lower case for
4030: 20 37 2d 62 69 74 20 4c 61 74 69 6e 0a 63 68 61   7-bit Latin.cha
4040: 72 61 63 74 65 72 73 2e 20 20 48 65 6e 63 65 20  racters.  Hence 
4050: 74 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  the LIKE operato
4060: 72 20 69 73 20 63 61 73 65 20 73 65 6e 73 69 74  r is case sensit
4070: 69 76 65 20 66 6f 72 0a 38 2d 62 69 74 20 69 73  ive for.8-bit is
4080: 6f 38 38 35 39 20 63 68 61 72 61 63 74 65 72 73  o8859 characters
4090: 20 6f 72 20 55 54 46 2d 38 20 63 68 61 72 61 63   or UTF-8 charac
40a0: 74 65 72 73 2e 20 20 46 6f 72 20 65 78 61 6d 70  ters.  For examp
40b0: 6c 65 2c 0a 74 68 65 20 65 78 70 72 65 73 73 69  le,.the expressi
40c0: 6f 6e 20 3c 62 3e 27 61 27 26 6e 62 73 70 3b 4c  on <b>'a'&nbsp;L
40d0: 49 4b 45 26 6e 62 73 70 3b 27 41 27 3c 2f 62 3e  IKE&nbsp;'A'</b>
40e0: 20 69 73 20 54 52 55 45 20 62 75 74 0a 3c 62 3e   is TRUE but.<b>
40f0: 27 26 61 65 6c 69 67 3b 27 26 6e 62 73 70 3b 4c  '&aelig;'&nbsp;L
4100: 49 4b 45 26 6e 62 73 70 3b 27 26 41 45 6c 69 67  IKE&nbsp;'&AElig
4110: 3b 27 3c 2f 62 3e 20 69 73 20 46 41 4c 53 45 2e  ;'</b> is FALSE.
4120: 29 0a 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47  ).</p>..<p>The G
4130: 4c 4f 42 20 6f 70 65 72 61 74 6f 72 20 69 73 20  LOB operator is 
4140: 73 69 6d 69 6c 61 72 20 74 6f 20 4c 49 4b 45 20  similar to LIKE 
4150: 62 75 74 20 75 73 65 73 20 74 68 65 20 55 6e 69  but uses the Uni
4160: 78 0a 66 69 6c 65 20 67 6c 6f 62 62 69 6e 67 20  x.file globbing 
4170: 73 79 6e 74 61 78 20 66 6f 72 20 69 74 73 20 77  syntax for its w
4180: 69 6c 64 63 61 72 64 73 2e 20 20 41 6c 73 6f 2c  ildcards.  Also,
4190: 20 47 4c 4f 42 20 69 73 20 63 61 73 65 0a 73 65   GLOB is case.se
41a0: 6e 73 69 74 69 76 65 2c 20 75 6e 6c 69 6b 65 20  nsitive, unlike 
41b0: 4c 49 4b 45 2e 20 20 42 6f 74 68 20 47 4c 4f 42  LIKE.  Both GLOB
41c0: 20 61 6e 64 20 4c 49 4b 45 20 6d 61 79 20 62 65   and LIKE may be
41d0: 20 70 72 65 63 65 64 65 64 20 62 79 0a 74 68 65   preceded by.the
41e0: 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20 74 6f 20   NOT keyword to 
41f0: 69 6e 76 65 72 74 20 74 68 65 20 73 65 6e 73 65  invert the sense
4200: 20 6f 66 20 74 68 65 20 74 65 73 74 2e 3c 2f 70   of the test.</p
4210: 3e 0a 0a 3c 70 3e 41 20 63 6f 6c 75 6d 6e 20 6e  >..<p>A column n
4220: 61 6d 65 20 63 61 6e 20 62 65 20 61 6e 79 20 6f  ame can be any o
4230: 66 20 74 68 65 20 6e 61 6d 65 73 20 64 65 66 69  f the names defi
4240: 6e 65 64 20 69 6e 20 74 68 65 20 43 52 45 41 54  ned in the CREAT
4250: 45 20 54 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e  E TABLE.statemen
4260: 74 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20  t or one of the 
4270: 66 6f 6c 6c 6f 77 69 6e 67 20 73 70 65 63 69 61  following specia
4280: 6c 20 69 64 65 6e 74 69 66 69 65 72 73 3a 20 22  l identifiers: "
4290: 3c 62 3e 52 4f 57 49 44 3c 2f 62 3e 22 2c 0a 22  <b>ROWID</b>",."
42a0: 3c 62 3e 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20  <b>OID</b>", or 
42b0: 22 3c 62 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22  "<b>_ROWID_</b>"
42c0: 2e 0a 54 68 65 73 65 20 73 70 65 63 69 61 6c 20  ..These special 
42d0: 69 64 65 6e 74 69 66 69 65 72 73 20 61 6c 6c 20  identifiers all 
42e0: 64 65 73 63 72 69 62 65 20 74 68 65 0a 75 6e 69  describe the.uni
42f0: 71 75 65 20 72 61 6e 64 6f 6d 20 69 6e 74 65 67  que random integ
4300: 65 72 20 6b 65 79 20 28 74 68 65 20 22 72 6f 77  er key (the "row
4310: 20 6b 65 79 22 29 20 61 73 73 6f 63 69 61 74 65   key") associate
4320: 64 20 77 69 74 68 20 65 76 65 72 79 20 0a 72 6f  d with every .ro
4330: 77 20 6f 66 20 65 76 65 72 79 20 74 61 62 6c 65  w of every table
4340: 2e 0a 54 68 65 20 73 70 65 63 69 61 6c 20 69 64  ..The special id
4350: 65 6e 74 69 66 69 65 72 73 20 6f 6e 6c 79 20 72  entifiers only r
4360: 65 66 65 72 20 74 6f 20 74 68 65 20 72 6f 77 20  efer to the row 
4370: 6b 65 79 20 69 66 20 74 68 65 20 43 52 45 41 54  key if the CREAT
4380: 45 20 54 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e  E TABLE.statemen
4390: 74 20 64 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e  t does not defin
43a0: 65 20 61 20 72 65 61 6c 20 63 6f 6c 75 6d 6e 20  e a real column 
43b0: 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61  with the same na
43c0: 6d 65 2e 20 20 52 6f 77 20 6b 65 79 73 0a 61 63  me.  Row keys.ac
43d0: 74 20 6c 69 6b 65 20 72 65 61 64 2d 6f 6e 6c 79  t like read-only
43e0: 20 63 6f 6c 75 6d 6e 73 2e 20 20 41 20 72 6f 77   columns.  A row
43f0: 20 6b 65 79 20 63 61 6e 20 62 65 20 75 73 65 64   key can be used
4400: 20 61 6e 79 77 68 65 72 65 20 61 20 72 65 67 75   anywhere a regu
4410: 6c 61 72 0a 63 6f 6c 75 6d 6e 20 63 61 6e 20 62  lar.column can b
4420: 65 20 75 73 65 64 2c 20 65 78 63 65 70 74 20 74  e used, except t
4430: 68 61 74 20 79 6f 75 20 63 61 6e 6e 6f 74 20 63  hat you cannot c
4440: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 0a  hange the value.
4450: 6f 66 20 61 20 72 6f 77 20 6b 65 79 20 69 6e 20  of a row key in 
4460: 61 6e 20 55 50 44 41 54 45 20 6f 72 20 49 4e 53  an UPDATE or INS
4470: 45 52 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 22  ERT statement.."
4480: 53 45 4c 45 43 54 20 2a 20 2e 2e 2e 22 20 64 6f  SELECT * ..." do
4490: 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 74 68  es not return th
44a0: 65 20 72 6f 77 20 6b 65 79 2e 3c 2f 70 3e 0a 0a  e row key.</p>..
44b0: 3c 70 3e 53 45 4c 45 43 54 20 73 74 61 74 65 6d  <p>SELECT statem
44c0: 65 6e 74 73 20 63 61 6e 20 61 70 70 65 61 72 20  ents can appear 
44d0: 69 6e 20 65 78 70 72 65 73 73 69 6f 6e 73 20 61  in expressions a
44e0: 73 20 65 69 74 68 65 72 20 74 68 65 0a 72 69 67  s either the.rig
44f0: 68 74 2d 68 61 6e 64 20 6f 70 65 72 61 6e 64 20  ht-hand operand 
4500: 6f 66 20 74 68 65 20 49 4e 20 6f 70 65 72 61 74  of the IN operat
4510: 6f 72 20 6f 72 20 61 73 20 61 20 73 63 61 6c 61  or or as a scala
4520: 72 20 71 75 61 6e 74 69 74 79 2e 0a 49 6e 20 62  r quantity..In b
4530: 6f 74 68 20 63 61 73 65 73 2c 20 74 68 65 20 53  oth cases, the S
4540: 45 4c 45 43 54 20 73 68 6f 75 6c 64 20 68 61 76  ELECT should hav
4550: 65 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20  e only a single 
4560: 63 6f 6c 75 6d 6e 20 69 6e 20 69 74 73 0a 72 65  column in its.re
4570: 73 75 6c 74 2e 20 20 43 6f 6d 70 6f 75 6e 64 20  sult.  Compound 
4580: 53 45 4c 45 43 54 73 20 28 63 6f 6e 6e 65 63 74  SELECTs (connect
4590: 65 64 20 77 69 74 68 20 6b 65 79 77 6f 72 64 73  ed with keywords
45a0: 20 6c 69 6b 65 20 55 4e 49 4f 4e 20 6f 72 0a 45   like UNION or.E
45b0: 58 43 45 50 54 29 20 61 72 65 20 61 6c 6c 6f 77  XCEPT) are allow
45c0: 65 64 2e 20 20 41 6e 79 20 4f 52 44 45 52 20 42  ed.  Any ORDER B
45d0: 59 20 63 6c 61 75 73 65 20 6f 6e 20 74 68 65 20  Y clause on the 
45e0: 73 65 6c 65 63 74 20 69 73 20 69 67 6e 6f 72 65  select is ignore
45f0: 64 2e 0a 41 20 53 45 4c 45 43 54 20 69 6e 20 61  d..A SELECT in a
4600: 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20  n expression is 
4610: 65 76 61 6c 75 61 74 65 64 20 6f 6e 63 65 20 62  evaluated once b
4620: 65 66 6f 72 65 20 61 6e 79 20 6f 74 68 65 72 20  efore any other 
4630: 70 72 6f 63 65 73 73 69 6e 67 0a 69 73 20 70 65  processing.is pe
4640: 72 66 6f 72 6d 65 64 2c 20 73 6f 20 6e 6f 6e 65  rformed, so none
4650: 20 6f 66 20 74 68 65 20 65 78 70 72 65 73 73 69   of the expressi
4660: 6f 6e 73 20 77 69 74 68 69 6e 20 74 68 65 20 73  ons within the s
4670: 65 6c 65 63 74 20 69 74 73 65 6c 66 20 63 61 6e  elect itself can
4680: 0a 72 65 66 65 72 20 74 6f 20 71 75 61 6e 74 69  .refer to quanti
4690: 74 69 65 73 20 69 6e 20 74 68 65 20 63 6f 6e 74  ties in the cont
46a0: 61 69 6e 69 6e 67 20 65 78 70 72 65 73 73 69 6f  aining expressio
46b0: 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20  n.</p>..<p>When 
46c0: 61 20 53 45 4c 45 43 54 20 69 73 20 74 68 65 20  a SELECT is the 
46d0: 72 69 67 68 74 20 6f 70 65 72 61 6e 64 20 6f 66  right operand of
46e0: 20 74 68 65 20 49 4e 20 6f 70 65 72 61 74 6f 72   the IN operator
46f0: 2c 20 74 68 65 20 49 4e 0a 6f 70 65 72 61 74 6f  , the IN.operato
4700: 72 20 72 65 74 75 72 6e 73 20 54 52 55 45 20 69  r returns TRUE i
4710: 66 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20  f the result of 
4720: 74 68 65 20 6c 65 66 74 20 6f 70 65 72 61 6e 64  the left operand
4730: 20 69 73 20 61 6e 79 20 6f 66 0a 74 68 65 20 76   is any of.the v
4740: 61 6c 75 65 73 20 67 65 6e 65 72 61 74 65 64 20  alues generated 
4750: 62 79 20 74 68 65 20 73 65 6c 65 63 74 2e 20 20  by the select.  
4760: 54 68 65 20 49 4e 20 6f 70 65 72 61 74 6f 72 20  The IN operator 
4770: 6d 61 79 20 62 65 20 70 72 65 63 65 64 65 64 0a  may be preceded.
4780: 62 79 20 74 68 65 20 4e 4f 54 20 6b 65 79 77 6f  by the NOT keywo
4790: 72 64 20 74 6f 20 69 6e 76 65 72 74 20 74 68 65  rd to invert the
47a0: 20 73 65 6e 73 65 20 6f 66 20 74 68 65 20 74 65   sense of the te
47b0: 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e  st.</p>..<p>When
47c0: 20 61 20 53 45 4c 45 43 54 20 61 70 70 65 61 72   a SELECT appear
47d0: 73 20 77 69 74 68 69 6e 20 61 6e 20 65 78 70 72  s within an expr
47e0: 65 73 73 69 6f 6e 20 62 75 74 20 69 73 20 6e 6f  ession but is no
47f0: 74 20 74 68 65 20 72 69 67 68 74 0a 6f 70 65 72  t the right.oper
4800: 61 6e 64 20 6f 66 20 61 6e 20 49 4e 20 6f 70 65  and of an IN ope
4810: 72 61 74 6f 72 2c 20 74 68 65 6e 20 74 68 65 20  rator, then the 
4820: 66 69 72 73 74 20 72 6f 77 20 6f 66 20 74 68 65  first row of the
4830: 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 0a 53   result of the.S
4840: 45 4c 45 43 54 20 62 65 63 6f 6d 65 73 20 74 68  ELECT becomes th
4850: 65 20 76 61 6c 75 65 20 75 73 65 64 20 69 6e 20  e value used in 
4860: 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 2e 20  the expression. 
4870: 20 49 66 20 74 68 65 20 53 45 4c 45 43 54 20 79   If the SELECT y
4880: 69 65 6c 64 73 0a 6d 6f 72 65 20 74 68 61 6e 20  ields.more than 
4890: 6f 6e 65 20 72 65 73 75 6c 74 20 72 6f 77 2c 20  one result row, 
48a0: 61 6c 6c 20 72 6f 77 73 20 61 66 74 65 72 20 74  all rows after t
48b0: 68 65 20 66 69 72 73 74 20 61 72 65 20 69 67 6e  he first are ign
48c0: 6f 72 65 64 2e 20 20 49 66 0a 74 68 65 20 53 45  ored.  If.the SE
48d0: 4c 45 43 54 20 79 65 69 6c 64 73 20 6e 6f 20 72  LECT yeilds no r
48e0: 6f 77 73 2c 20 74 68 65 6e 20 74 68 65 20 76 61  ows, then the va
48f0: 6c 75 65 20 6f 66 20 74 68 65 20 53 45 4c 45 43  lue of the SELEC
4900: 54 20 69 73 20 4e 55 4c 4c 2e 3c 2f 70 3e 0a 0a  T is NULL.</p>..
4910: 3c 70 3e 54 68 65 20 65 78 70 72 65 73 73 69 6f  <p>The expressio
4920: 6e 20 73 79 6e 74 61 78 20 63 75 72 72 65 6e 74  n syntax current
4930: 6c 79 20 73 75 70 70 6f 72 74 73 20 74 68 65 20  ly supports the 
4940: 66 6f 6c 6c 6f 77 69 6e 67 0a 66 75 6e 63 74 69  following.functi
4950: 6f 6e 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b  ons:</p>..<block
4960: 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e  quote><pre>.<fon
4970: 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30  t color="#2c2cf0
4980: 22 3e 3c 62 69 67 3e 63 6f 75 6e 74 20 20 20 20  "><big>count    
4990: 6d 69 6e 20 20 20 20 20 20 20 6d 61 78 20 20 20  min       max   
49a0: 20 20 20 20 73 75 6d 0a 61 76 67 20 20 20 20 20      sum.avg     
49b0: 20 6c 65 6e 67 74 68 20 20 20 20 73 75 62 73 74   length    subst
49c0: 72 20 20 20 20 61 62 73 20 20 20 20 20 20 20 72  r    abs       r
49d0: 6f 75 6e 64 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74  ound</big></font
49e0: 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71  >.</pre></blockq
49f0: 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66  uote>..<p>.The f
4a00: 75 6e 63 74 69 6f 6e 73 20 3c 62 3e 63 6f 75 6e  unctions <b>coun
4a10: 74 3c 2f 62 3e 2c 20 3c 62 3e 73 75 6d 3c 2f 62  t</b>, <b>sum</b
4a20: 3e 2c 20 61 6e 64 20 3c 62 3e 61 76 67 3c 2f 62  >, and <b>avg</b
4a30: 3e 20 61 6e 64 20 74 68 65 20 66 75 6e 63 74 69  > and the functi
4a40: 6f 6e 73 0a 3c 62 3e 6d 69 6e 3c 2f 62 3e 20 61  ons.<b>min</b> a
4a50: 6e 64 20 3c 62 3e 6d 61 78 3c 2f 62 3e 20 75 73  nd <b>max</b> us
4a60: 65 64 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65  ed with only one
4a70: 20 61 72 67 75 6d 65 6e 74 20 61 72 65 20 61 6c   argument are al
4a80: 6c 20 61 67 67 72 65 67 61 74 65 0a 66 75 6e 63  l aggregate.func
4a90: 74 69 6f 6e 73 2e 20 20 54 68 69 73 20 6d 65 61  tions.  This mea
4aa0: 6e 73 20 74 68 61 74 20 74 68 65 79 20 61 72 65  ns that they are
4ab0: 20 63 6f 6d 70 75 74 65 64 20 61 63 72 6f 73 73   computed across
4ac0: 20 61 6c 6c 20 72 6f 77 73 20 6f 66 20 74 68 65   all rows of the
4ad0: 20 72 65 73 75 6c 74 2e 0a 54 68 65 20 66 75 6e   result..The fun
4ae0: 63 74 69 6f 6e 73 20 3c 62 3e 6d 69 6e 3c 2f 62  ctions <b>min</b
4af0: 3e 20 61 6e 64 20 3c 62 3e 6d 61 78 3c 2f 62 3e  > and <b>max</b>
4b00: 0a 77 69 74 68 20 74 77 6f 20 6f 72 20 6d 6f 72  .with two or mor
4b10: 65 20 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 20  e arguments and 
4b20: 61 6c 6c 20 6f 74 68 65 72 20 66 75 6e 63 74 69  all other functi
4b30: 6f 6e 73 0a 61 72 65 20 6e 6f 6e 2d 61 67 67 72  ons.are non-aggr
4b40: 65 67 61 74 65 73 2e 20 20 4e 6f 6e 2d 61 67 67  egates.  Non-agg
4b50: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73  regate functions
4b60: 0a 61 72 65 20 63 6f 6d 70 75 74 65 64 20 73 65  .are computed se
4b70: 70 61 72 61 74 65 6c 79 20 66 6f 72 20 65 61 63  parately for eac
4b80: 68 20 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73  h row of the res
4b90: 75 6c 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54  ult..</p>..<p>.T
4ba0: 68 65 20 3c 62 3e 72 6f 75 6e 64 3c 2f 62 3e 20  he <b>round</b> 
4bb0: 66 75 6e 63 74 69 6f 6e 20 63 61 6e 20 74 61 6b  function can tak
4bc0: 65 20 65 69 74 68 65 72 20 31 20 6f 72 20 32 20  e either 1 or 2 
4bd0: 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 0a  arguments.  The.
4be0: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69  first argument i
4bf0: 73 20 74 68 65 20 66 6c 6f 61 74 69 6e 67 20 70  s the floating p
4c00: 6f 69 6e 74 20 76 61 6c 75 65 20 74 68 61 74 20  oint value that 
4c10: 69 73 20 72 6f 75 6e 64 65 64 2e 20 20 54 68 65  is rounded.  The
4c20: 0a 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74  .second argument
4c30: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   is the number o
4c40: 66 20 64 69 67 69 74 73 20 74 6f 20 74 68 65 20  f digits to the 
4c50: 72 69 67 68 74 20 6f 66 20 74 68 65 0a 64 65 63  right of the.dec
4c60: 69 6d 61 6c 20 70 6f 69 6e 74 20 74 6f 20 70 72  imal point to pr
4c70: 65 73 65 72 76 65 2e 20 20 49 66 20 74 68 65 20  eserve.  If the 
4c80: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20  second argument 
4c90: 69 73 20 6f 6d 69 74 74 65 64 2c 0a 7a 65 72 6f  is omitted,.zero
4ca0: 20 69 73 20 61 73 73 75 6d 65 64 2e 20 20 53 6f   is assumed.  So
4cb0: 20 72 6f 75 6e 64 28 31 2e 32 33 34 35 36 2c 32   round(1.23456,2
4cc0: 29 20 69 73 20 31 2e 32 33 20 61 6e 64 0a 72 6f  ) is 1.23 and.ro
4cd0: 75 6e 64 28 31 32 2e 33 34 2c 30 29 20 61 6e 64  und(12.34,0) and
4ce0: 20 72 6f 75 6e 64 28 31 32 2e 33 34 29 20 62 6f   round(12.34) bo
4cf0: 74 68 20 65 76 61 6c 75 61 74 65 20 74 6f 20 31  th evaluate to 1
4d00: 32 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65  2..</p>..<p>.The
4d10: 20 22 3c 62 3e 63 6f 75 6e 74 28 2a 29 3c 2f 62   "<b>count(*)</b
4d20: 3e 22 20 73 79 6e 74 61 78 20 69 73 20 73 75 70  >" syntax is sup
4d30: 70 6f 72 74 65 64 20 62 75 74 0a 22 3c 62 3e 63  ported but."<b>c
4d40: 6f 75 6e 74 28 64 69 73 74 69 6e 63 74 3c 2f 62  ount(distinct</b
4d50: 3e 20 3c 69 3e 43 4f 4c 55 4d 4e 2d 4e 41 4d 45  > <i>COLUMN-NAME
4d60: 3c 2f 69 3e 3c 62 3e 29 3c 2f 62 3e 22 20 69 73  </i><b>)</b>" is
4d70: 20 6e 6f 74 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65   not..</p>.}..Se
4d80: 63 74 69 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73  ction INSERT ins
4d90: 65 72 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  ert..Syntax {sql
4da0: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e  -statement} {.IN
4db0: 53 45 52 54 20 5b 4f 52 20 3c 63 6f 6e 66 6c 69  SERT [OR <confli
4dc0: 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 5d 20 49  ct-algorithm>] I
4dd0: 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  NTO <table-name>
4de0: 20 5b 28 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e   [(<column-list>
4df0: 29 5d 20 56 41 4c 55 45 53 28 3c 76 61 6c 75 65  )] VALUES(<value
4e00: 2d 6c 69 73 74 3e 29 20 7c 0a 49 4e 53 45 52 54  -list>) |.INSERT
4e10: 20 5b 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61   [OR <conflict-a
4e20: 6c 67 6f 72 69 74 68 6d 3e 5d 20 49 4e 54 4f 20  lgorithm>] INTO 
4e30: 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 3c  <table-name> [(<
4e40: 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 29 5d 20 3c  column-list>)] <
4e50: 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74  select-statement
4e60: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  >.}..puts {.<p>T
4e70: 68 65 20 49 4e 53 45 52 54 20 73 74 61 74 65 6d  he INSERT statem
4e80: 65 6e 74 20 63 6f 6d 65 73 20 69 6e 20 74 77 6f  ent comes in two
4e90: 20 62 61 73 69 63 20 66 6f 72 6d 73 2e 20 20 54   basic forms.  T
4ea0: 68 65 20 66 69 72 73 74 20 66 6f 72 6d 0a 28 77  he first form.(w
4eb0: 69 74 68 20 74 68 65 20 22 56 41 4c 55 45 53 22  ith the "VALUES"
4ec0: 20 6b 65 79 77 6f 72 64 29 20 63 72 65 61 74 65   keyword) create
4ed0: 73 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 20 72  s a single new r
4ee0: 6f 77 20 69 6e 20 61 6e 20 65 78 69 73 74 69 6e  ow in an existin
4ef0: 67 20 74 61 62 6c 65 2e 0a 49 66 20 6e 6f 20 63  g table..If no c
4f00: 6f 6c 75 6d 6e 2d 6c 69 73 74 20 69 73 20 73 70  olumn-list is sp
4f10: 65 63 69 66 69 65 64 20 74 68 65 6e 20 74 68 65  ecified then the
4f20: 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65   number of value
4f30: 73 20 6d 75 73 74 0a 62 65 20 74 68 65 20 73 61  s must.be the sa
4f40: 6d 65 20 61 73 20 74 68 65 20 6e 75 6d 62 65 72  me as the number
4f50: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
4f60: 68 65 20 74 61 62 6c 65 2e 20 20 49 66 20 61 20  he table.  If a 
4f70: 63 6f 6c 75 6d 6e 2d 6c 69 73 74 0a 69 73 20 73  column-list.is s
4f80: 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 74  pecified, then t
4f90: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c  he number of val
4fa0: 75 65 73 20 6d 75 73 74 20 6d 61 74 63 68 20 74  ues must match t
4fb0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 73 70 65  he number of.spe
4fc0: 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 73 2e 20  cified columns. 
4fd0: 20 43 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20   Columns of the 
4fe0: 74 61 62 6c 65 20 74 68 61 74 20 64 6f 20 6e 6f  table that do no
4ff0: 74 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 0a  t appear in the.
5000: 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 61 72 65 20  column list are 
5010: 66 69 6c 6c 20 77 69 74 68 20 74 68 65 20 64 65  fill with the de
5020: 66 61 75 6c 74 20 76 61 6c 75 65 2c 20 6f 72 20  fault value, or 
5030: 77 69 74 68 20 4e 55 4c 4c 20 69 66 20 6e 6f 74  with NULL if not
5040: 0a 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69  .default value i
5050: 73 20 73 70 65 63 69 66 69 65 64 2e 0a 3c 2f 70  s specified..</p
5060: 3e 0a 0a 3c 70 3e 54 68 65 20 73 65 63 6f 6e 64  >..<p>The second
5070: 20 66 6f 72 6d 20 6f 66 20 74 68 65 20 49 4e 53   form of the INS
5080: 45 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 61  ERT statement ta
5090: 6b 65 73 20 69 74 20 64 61 74 61 20 66 72 6f 6d  kes it data from
50a0: 20 61 0a 53 45 4c 45 43 54 20 73 74 61 74 65 6d   a.SELECT statem
50b0: 65 6e 74 2e 20 20 54 68 65 20 6e 75 6d 62 65 72  ent.  The number
50c0: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
50d0: 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65  he result of the
50e0: 0a 53 45 4c 45 43 54 20 6d 75 73 74 20 65 78 61  .SELECT must exa
50f0: 63 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 6e  ctly match the n
5100: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
5110: 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 69 66   in the table if
5120: 0a 6e 6f 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 20  .no column list 
5130: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 6f 72  is specified, or
5140: 20 69 74 20 6d 75 73 74 20 6d 61 74 63 68 20 74   it must match t
5150: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c  he number of col
5160: 75 6d 6e 73 0a 6e 61 6d 65 20 69 6e 20 74 68 65  umns.name in the
5170: 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 2e 20 20 41   column list.  A
5180: 20 6e 65 77 20 65 6e 74 72 79 20 69 73 20 6d 61   new entry is ma
5190: 64 65 20 69 6e 20 74 68 65 20 74 61 62 6c 65 0a  de in the table.
51a0: 66 6f 72 20 65 76 65 72 79 20 72 6f 77 20 6f 66  for every row of
51b0: 20 74 68 65 20 53 45 4c 45 43 54 20 72 65 73 75   the SELECT resu
51c0: 6c 74 2e 20 20 54 68 65 20 53 45 4c 45 43 54 20  lt.  The SELECT 
51d0: 6d 61 79 20 62 65 20 73 69 6d 70 6c 65 0a 6f 72  may be simple.or
51e0: 20 63 6f 6d 70 6f 75 6e 64 2e 20 20 49 66 20 74   compound.  If t
51f0: 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d  he SELECT statem
5200: 65 6e 74 20 68 61 73 20 61 6e 20 4f 52 44 45 52  ent has an ORDER
5210: 20 42 59 20 63 6c 61 75 73 65 2c 0a 74 68 65 20   BY clause,.the 
5220: 4f 52 44 45 52 20 42 59 20 69 73 20 69 67 6e 6f  ORDER BY is igno
5230: 72 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  red.</p>..<p>The
5240: 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69   optional confli
5250: 63 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73  ct-clause allows
5260: 20 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69   the specificati
5270: 6f 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61  on of an alterna
5280: 74 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20  tive.constraint 
5290: 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74  conflict resolut
52a0: 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f  ion algorithm to
52b0: 20 75 73 65 20 64 75 72 69 6e 67 20 74 68 69 73   use during this
52c0: 20 6f 6e 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65   one command..Se
52d0: 65 20 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69  e the section ti
52e0: 74 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63  tled.<a href="#c
52f0: 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46  onflict">ON CONF
5300: 4c 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64  LICT</a> for add
5310: 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74  itional informat
5320: 69 6f 6e 2e 0a 46 6f 72 20 63 6f 6d 70 61 74 69  ion..For compati
5330: 62 69 6c 69 74 79 20 77 69 74 68 20 4d 79 53 51  bility with MySQ
5340: 4c 2c 20 74 68 65 20 70 61 72 73 65 72 20 61 6c  L, the parser al
5350: 6c 6f 77 73 20 74 68 65 20 75 73 65 20 6f 66 20  lows the use of 
5360: 74 68 65 0a 73 69 6e 67 6c 65 20 6b 65 79 77 6f  the.single keywo
5370: 72 64 20 22 52 45 50 4c 41 43 45 22 20 61 73 20  rd "REPLACE" as 
5380: 61 6e 20 61 6c 69 61 73 20 66 6f 72 20 22 49 4e  an alias for "IN
5390: 53 45 52 54 20 4f 52 20 52 45 50 4c 41 43 45 22  SERT OR REPLACE"
53a0: 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f  ..</p>.}..Sectio
53b0: 6e 20 7b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63  n {ON CONFLICT c
53c0: 6c 61 75 73 65 7d 20 63 6f 6e 66 6c 69 63 74 0a  lause} conflict.
53d0: 0a 53 79 6e 74 61 78 20 7b 63 6f 6e 66 6c 69 63  .Syntax {conflic
53e0: 74 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f 4e 20 43  t-clause} {.ON C
53f0: 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63  ONFLICT <conflic
5400: 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 0a 7d 20 7b  t-algorithm>.} {
5410: 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74  conflict-algorit
5420: 68 6d 7d 20 7b 0a 52 4f 4c 4c 42 41 43 4b 20 7c  hm} {.ROLLBACK |
5430: 20 41 42 4f 52 54 20 7c 20 46 41 49 4c 20 7c 20   ABORT | FAIL | 
5440: 49 47 4e 4f 52 45 20 7c 20 52 45 50 4c 41 43 45  IGNORE | REPLACE
5450: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
5460: 65 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c  e ON CONFLICT cl
5470: 61 75 73 65 20 69 73 20 6e 6f 74 20 61 20 73 65  ause is not a se
5480: 70 61 72 61 74 65 20 53 51 4c 20 63 6f 6d 6d 61  parate SQL comma
5490: 6e 64 2e 20 20 49 74 20 69 73 20 61 0a 6e 6f 6e  nd.  It is a.non
54a0: 2d 73 74 61 6e 64 61 72 64 20 63 6c 61 75 73 65  -standard clause
54b0: 20 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72   that can appear
54c0: 20 69 6e 20 6d 61 6e 79 20 6f 74 68 65 72 20 53   in many other S
54d0: 51 4c 20 63 6f 6d 6d 61 6e 64 73 2e 0a 49 74 20  QL commands..It 
54e0: 69 73 20 67 69 76 65 6e 20 69 74 73 20 6f 77 6e  is given its own
54f0: 20 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 69 73   section in this
5500: 20 64 6f 63 75 6d 65 6e 74 20 62 65 63 61 75 73   document becaus
5510: 65 20 69 74 20 69 73 20 6e 6f 74 0a 70 61 72 74  e it is not.part
5520: 20 6f 66 20 73 74 61 6e 64 61 72 64 20 53 51 4c   of standard SQL
5530: 20 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 6d   and therefore m
5540: 69 67 68 74 20 6e 6f 74 20 62 65 20 66 61 6d 69  ight not be fami
5550: 6c 69 61 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  liar.</p>..<p>Th
5560: 65 20 73 79 6e 74 61 78 20 66 6f 72 20 74 68 65  e syntax for the
5570: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
5580: 75 73 65 20 69 73 20 61 73 20 73 68 6f 77 6e 20  use is as shown 
5590: 61 62 6f 76 65 20 66 6f 72 0a 74 68 65 20 43 52  above for.the CR
55a0: 45 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45 41  EATE TABLE, CREA
55b0: 54 45 20 49 4e 44 45 58 2c 20 61 6e 64 20 42 45  TE INDEX, and BE
55c0: 47 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20  GIN TRANSACTION 
55d0: 63 6f 6d 6d 61 6e 64 73 2e 0a 46 6f 72 20 74 68  commands..For th
55e0: 65 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20  e COPY, INSERT, 
55f0: 61 6e 64 20 55 50 44 41 54 45 20 63 6f 6d 6d 61  and UPDATE comma
5600: 6e 64 73 2c 20 74 68 65 20 6b 65 79 77 6f 72 64  nds, the keyword
5610: 73 0a 22 4f 4e 20 43 4f 4e 46 4c 49 43 54 22 20  s."ON CONFLICT" 
5620: 61 72 65 20 72 65 70 6c 61 63 65 64 20 62 79 20  are replaced by 
5630: 22 4f 52 22 2c 20 74 6f 20 6d 61 6b 65 20 74 68  "OR", to make th
5640: 65 20 73 79 6e 74 61 78 20 73 65 65 6d 20 6d 6f  e syntax seem mo
5650: 72 65 0a 6e 61 74 75 72 61 6c 2e 20 20 42 75 74  re.natural.  But
5660: 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20   the meaning of 
5670: 74 68 65 20 63 6c 61 75 73 65 20 69 73 20 74 68  the clause is th
5680: 65 20 73 61 6d 65 20 65 69 74 68 65 72 20 77 61  e same either wa
5690: 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f  y.</p>..<p>The O
56a0: 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73  N CONFLICT claus
56b0: 65 20 73 70 65 63 69 66 69 65 73 20 61 6e 20 61  e specifies an a
56c0: 6c 67 6f 72 69 74 68 6d 20 75 73 65 64 20 74 6f  lgorithm used to
56d0: 20 72 65 73 6f 6c 76 65 0a 63 6f 6e 73 74 72 61   resolve.constra
56e0: 69 6e 74 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20  int conflicts.  
56f0: 54 68 65 72 65 20 61 72 65 20 66 69 76 65 20 63  There are five c
5700: 68 6f 69 63 65 73 3a 20 52 4f 4c 4c 42 41 43 4b  hoices: ROLLBACK
5710: 2c 20 41 42 4f 52 54 2c 0a 46 41 49 4c 2c 20 49  , ABORT,.FAIL, I
5720: 47 4e 4f 52 45 2c 20 61 6e 64 20 52 45 50 4c 41  GNORE, and REPLA
5730: 43 45 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20  CE. The default 
5740: 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 41 42 4f  algorithm is ABO
5750: 52 54 2e 20 20 54 68 69 73 0a 69 73 20 77 68 61  RT.  This.is wha
5760: 74 20 74 68 65 79 20 6d 65 61 6e 3a 3c 2f 70 3e  t they mean:</p>
5770: 0a 0a 3c 64 6c 3e 0a 3c 64 74 3e 3c 62 3e 52 4f  ..<dl>.<dt><b>RO
5780: 4c 4c 42 41 43 4b 3c 2f 62 3e 3c 2f 64 74 3e 0a  LLBACK</b></dt>.
5790: 3c 64 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f  <dd><p>When a co
57a0: 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69  nstraint violati
57b0: 6f 6e 20 6f 63 63 75 72 73 2c 20 61 6e 20 69 6d  on occurs, an im
57c0: 6d 65 64 69 61 74 65 20 52 4f 4c 4c 42 41 43 4b  mediate ROLLBACK
57d0: 0a 6f 63 63 75 72 73 2c 20 74 68 75 73 20 65 6e  .occurs, thus en
57e0: 64 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74  ding the current
57f0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e   transaction, an
5800: 64 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 62  d the command ab
5810: 6f 72 74 73 0a 77 69 74 68 20 61 20 72 65 74 75  orts.with a retu
5820: 72 6e 20 63 6f 64 65 20 6f 66 20 53 51 4c 49 54  rn code of SQLIT
5830: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20 20 49  E_CONSTRAINT.  I
5840: 66 20 6e 6f 20 74 72 61 6e 73 61 63 74 69 6f 6e  f no transaction
5850: 20 69 73 0a 61 63 74 69 76 65 20 28 6f 74 68 65   is.active (othe
5860: 72 20 74 68 61 6e 20 74 68 65 20 69 6d 70 6c 69  r than the impli
5870: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74  ed transaction t
5880: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 6f  hat is created o
5890: 6e 20 65 76 65 72 79 0a 63 6f 6d 6d 61 6e 64 29  n every.command)
58a0: 20 74 68 65 6e 20 74 68 69 73 20 61 6c 67 6f 72   then this algor
58b0: 69 74 68 6d 20 77 6f 72 6b 73 20 74 68 65 20 73  ithm works the s
58c0: 61 6d 65 20 61 73 20 41 42 4f 52 54 2e 3c 2f 70  ame as ABORT.</p
58d0: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 41  ></dd>..<dt><b>A
58e0: 42 4f 52 54 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64  BORT</b></dt>.<d
58f0: 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73  d><p>When a cons
5900: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e  traint violation
5910: 20 6f 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d   occurs, the com
5920: 6d 61 6e 64 20 62 61 63 6b 73 20 6f 75 74 0a 61  mand backs out.a
5930: 6e 79 20 70 72 69 6f 72 20 63 68 61 6e 67 65 73  ny prior changes
5940: 20 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 6d   it might have m
5950: 61 64 65 20 61 6e 64 20 61 62 6f 72 74 73 20 77  ade and aborts w
5960: 69 74 68 20 61 20 72 65 74 75 72 6e 20 63 6f 64  ith a return cod
5970: 65 0a 6f 66 20 53 51 4c 49 54 45 5f 43 4f 4e 53  e.of SQLITE_CONS
5980: 54 52 41 49 4e 54 2e 20 20 42 75 74 20 6e 6f 20  TRAINT.  But no 
5990: 52 4f 4c 4c 42 41 43 4b 20 69 73 20 65 78 65 63  ROLLBACK is exec
59a0: 75 74 65 64 20 73 6f 20 63 68 61 6e 67 65 73 0a  uted so changes.
59b0: 66 72 6f 6d 20 70 72 69 6f 72 20 63 6f 6d 6d 61  from prior comma
59c0: 6e 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 73  nds within the s
59d0: 61 6d 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a  ame transaction.
59e0: 61 72 65 20 70 72 65 73 65 72 76 65 64 2e 20 20  are preserved.  
59f0: 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61  This is the defa
5a00: 75 6c 74 20 62 65 68 61 76 69 6f 72 2e 3c 2f 70  ult behavior.</p
5a10: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 46  ></dd>..<dt><b>F
5a20: 41 49 4c 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64  AIL</b></dt>.<dd
5a30: 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74  ><p>When a const
5a40: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
5a50: 6f 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d  occurs, the comm
5a60: 61 6e 64 20 61 62 6f 72 74 73 20 77 69 74 68 20  and aborts with 
5a70: 61 0a 72 65 74 75 72 6e 20 63 6f 64 65 20 53 51  a.return code SQ
5a80: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e  LITE_CONSTRAINT.
5a90: 20 20 42 75 74 20 61 6e 79 20 63 68 61 6e 67 65    But any change
5aa0: 73 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73  s to the databas
5ab0: 65 20 74 68 61 74 0a 74 68 65 20 63 6f 6d 6d 61  e that.the comma
5ac0: 6e 64 20 6d 61 64 65 20 70 72 69 6f 72 20 74 6f  nd made prior to
5ad0: 20 65 6e 63 6f 75 6e 74 65 72 69 6e 67 20 74 68   encountering th
5ae0: 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f  e constraint vio
5af0: 6c 61 74 69 6f 6e 0a 61 72 65 20 70 72 65 73 65  lation.are prese
5b00: 72 76 65 64 20 61 6e 64 20 61 72 65 20 6e 6f 74  rved and are not
5b10: 20 62 61 63 6b 65 64 20 6f 75 74 2e 20 20 46 6f   backed out.  Fo
5b20: 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 6e  r example, if an
5b30: 20 55 50 44 41 54 45 0a 73 74 61 74 65 6d 65 6e   UPDATE.statemen
5b40: 74 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 20  t encountered a 
5b50: 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61  constraint viola
5b60: 74 69 6f 6e 20 6f 6e 20 74 68 65 20 31 30 30 74  tion on the 100t
5b70: 68 20 72 6f 77 20 74 68 61 74 0a 69 74 20 61 74  h row that.it at
5b80: 74 65 6d 70 74 73 20 74 6f 20 75 70 64 61 74 65  tempts to update
5b90: 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 74  , then the first
5ba0: 20 39 39 20 72 6f 77 20 63 68 61 6e 67 65 73 20   99 row changes 
5bb0: 61 72 65 20 70 72 65 73 65 72 76 65 64 0a 62 75  are preserved.bu
5bc0: 74 20 63 68 61 6e 67 65 73 20 74 6f 20 72 6f 77  t changes to row
5bd0: 73 20 31 30 30 20 61 6e 64 20 62 65 79 6f 6e 64  s 100 and beyond
5be0: 20 6e 65 76 65 72 20 6f 63 63 75 72 2e 3c 2f 70   never occur.</p
5bf0: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 49  ></dd>..<dt><b>I
5c00: 47 4e 4f 52 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c  GNORE</b></dt>.<
5c10: 64 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e  dd><p>When a con
5c20: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
5c30: 6e 20 6f 63 63 75 72 73 2c 20 74 68 65 20 6f 6e  n occurs, the on
5c40: 65 20 72 6f 77 20 74 68 61 74 20 63 6f 6e 74 61  e row that conta
5c50: 69 6e 73 0a 74 68 65 20 63 6f 6e 73 74 72 61 69  ins.the constrai
5c60: 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20  nt violation is 
5c70: 6e 6f 74 20 69 6e 73 65 72 74 65 64 20 6f 72 20  not inserted or 
5c80: 63 68 61 6e 67 65 64 2e 20 20 42 75 74 20 74 68  changed.  But th
5c90: 65 20 63 6f 6d 6d 61 6e 64 0a 63 6f 6e 74 69 6e  e command.contin
5ca0: 75 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e 6f  ues executing no
5cb0: 72 6d 61 6c 6c 79 2e 20 20 4f 74 68 65 72 20 72  rmally.  Other r
5cc0: 6f 77 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61  ows before and a
5cd0: 66 74 65 72 20 74 68 65 20 72 6f 77 20 74 68 61  fter the row tha
5ce0: 74 0a 63 6f 6e 74 61 69 6e 65 64 20 74 68 65 20  t.contained the 
5cf0: 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61  constraint viola
5d00: 74 69 6f 6e 20 63 6f 6e 74 69 6e 75 65 20 74 6f  tion continue to
5d10: 20 62 65 20 69 6e 73 65 72 74 65 64 20 6f 72 20   be inserted or 
5d20: 75 70 64 61 74 65 64 0a 6e 6f 72 6d 61 6c 6c 79  updated.normally
5d30: 2e 20 20 4e 6f 20 65 72 72 6f 72 20 69 73 20 72  .  No error is r
5d40: 65 74 75 72 6e 65 64 2e 3c 2f 70 3e 3c 2f 64 64  eturned.</p></dd
5d50: 3e 0a 0a 3c 64 74 3e 3c 62 3e 52 45 50 4c 41 43  >..<dt><b>REPLAC
5d60: 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c  E</b></dt>.<dd><
5d70: 70 3e 57 68 65 6e 20 61 20 55 4e 49 51 55 45 20  p>When a UNIQUE 
5d80: 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61  constraint viola
5d90: 74 69 6f 6e 20 6f 63 63 75 72 73 2c 20 74 68 65  tion occurs, the
5da0: 20 70 72 65 2d 65 78 69 73 74 69 6e 67 20 72 6f   pre-existing ro
5db0: 77 0a 74 68 61 74 20 69 73 20 63 61 75 73 69 6e  w.that is causin
5dc0: 67 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74  g the constraint
5dd0: 20 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 72 65   violation is re
5de0: 6d 6f 76 65 64 20 70 72 69 6f 72 20 74 6f 20 69  moved prior to i
5df0: 6e 73 65 72 74 69 6e 67 0a 6f 72 20 75 70 64 61  nserting.or upda
5e00: 74 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74  ting the current
5e10: 20 72 6f 77 2e 20 20 54 68 75 73 20 74 68 65 20   row.  Thus the 
5e20: 69 6e 73 65 72 74 20 6f 72 20 75 70 64 61 74 65  insert or update
5e30: 20 61 6c 77 61 79 73 20 6f 63 63 75 72 73 2e 0a   always occurs..
5e40: 54 68 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 74  The command cont
5e50: 69 6e 75 65 73 20 65 78 65 63 75 74 69 6e 67 20  inues executing 
5e60: 6e 6f 72 6d 61 6c 6c 79 2e 20 20 4e 6f 20 65 72  normally.  No er
5e70: 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 2e  ror is returned.
5e80: 3c 2f 70 3e 0a 3c 70 3e 49 66 20 61 20 4e 4f 54  </p>.<p>If a NOT
5e90: 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74   NULL constraint
5ea0: 20 76 69 6f 6c 61 74 69 6f 6e 20 6f 63 63 75 72   violation occur
5eb0: 73 2c 20 74 68 65 20 4e 55 4c 4c 20 76 61 6c 75  s, the NULL valu
5ec0: 65 20 69 73 20 72 65 70 6c 61 63 65 64 0a 62 79  e is replaced.by
5ed0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c   the default val
5ee0: 75 65 20 66 6f 72 20 74 68 61 74 20 63 6f 6c 75  ue for that colu
5ef0: 6d 6e 2e 20 20 49 66 20 74 68 65 20 63 6f 6c 75  mn.  If the colu
5f00: 6d 6e 20 68 61 73 20 6e 6f 20 64 65 66 61 75 6c  mn has no defaul
5f10: 74 0a 76 61 6c 75 65 2c 20 74 68 65 6e 20 74 68  t.value, then th
5f20: 65 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68  e ABORT algorith
5f30: 6d 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 3c  m is used.</p>.<
5f40: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 70 3e 0a  /dd>.</dl>..<p>.
5f50: 54 68 65 20 63 6f 6e 66 6c 69 63 74 20 72 65 73  The conflict res
5f60: 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  olution algorith
5f70: 6d 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69  m can be specifi
5f80: 65 64 20 69 6e 20 74 68 72 65 65 20 70 6c 61 63  ed in three plac
5f90: 65 73 2c 0a 69 6e 20 6f 72 64 65 72 20 66 72 6f  es,.in order fro
5fa0: 6d 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 68  m lowest to high
5fb0: 65 73 74 20 70 72 65 63 65 64 65 6e 63 65 3a 0a  est precedence:.
5fc0: 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c  </p>..<ol>.<li><
5fd0: 70 3e 0a 4f 6e 20 61 20 42 45 47 49 4e 20 54 52  p>.On a BEGIN TR
5fe0: 41 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e  ANSACTION comman
5ff0: 64 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c  d..</p></li>..<l
6000: 69 3e 3c 70 3e 0a 4f 6e 20 69 6e 64 69 76 69 64  i><p>.On individ
6010: 75 61 6c 20 63 6f 6e 73 74 72 61 69 6e 74 73 20  ual constraints 
6020: 77 69 74 68 69 6e 20 61 20 43 52 45 41 54 45 20  within a CREATE 
6030: 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20  TABLE or CREATE 
6040: 49 4e 44 45 58 0a 73 74 61 74 65 6d 65 6e 74 2e  INDEX.statement.
6050: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e  .</p></li>..<li>
6060: 3c 70 3e 0a 49 6e 20 74 68 65 20 4f 52 20 63 6c  <p>.In the OR cl
6070: 61 75 73 65 20 6f 66 20 61 20 43 4f 50 59 2c 20  ause of a COPY, 
6080: 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54  INSERT, or UPDAT
6090: 45 20 63 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70 3e 3c  E command..</p><
60a0: 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54  /li>.</ol>..<p>T
60b0: 68 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65  he algorithm spe
60c0: 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 4f 52  cified in the OR
60d0: 20 63 6c 61 75 73 65 20 6f 66 20 61 20 43 4f 50   clause of a COP
60e0: 59 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50  Y, INSERT, or UP
60f0: 44 41 54 45 0a 6f 76 65 72 72 69 64 65 73 20 61  DATE.overrides a
6100: 6e 79 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65  ny algorithm spe
6110: 63 69 66 69 65 64 20 62 79 20 61 20 43 52 45 41  cified by a CREA
6120: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
6130: 54 45 20 49 4e 44 45 58 2e 0a 54 68 65 20 61 6c  TE INDEX..The al
6140: 67 6f 72 69 74 68 6d 20 73 70 65 63 69 66 69 65  gorithm specifie
6150: 64 20 77 69 74 68 69 6e 20 61 20 43 52 45 41 54  d within a CREAT
6160: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
6170: 45 20 49 4e 44 45 58 20 77 69 6c 6c 2c 20 69 6e  E INDEX will, in
6180: 20 74 75 72 6e 2c 0a 6f 76 65 72 72 69 64 65 20   turn,.override 
6190: 74 68 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70  the algorithm sp
61a0: 65 63 69 66 69 65 64 20 62 79 20 61 20 42 45 47  ecified by a BEG
61b0: 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63  IN TRANSACTION c
61c0: 6f 6d 6d 61 6e 64 2e 0a 49 66 20 6e 6f 20 61 6c  ommand..If no al
61d0: 67 6f 72 69 74 68 6d 20 69 73 20 73 70 65 63 69  gorithm is speci
61e0: 66 69 65 64 20 61 6e 79 77 68 65 72 65 2c 20 74  fied anywhere, t
61f0: 68 65 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74  he ABORT algorit
6200: 68 6d 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a  hm is used.</p>.
6210: 0a 7d 0a 23 20 3c 70 3e 46 6f 72 20 61 64 64 69  .}.# <p>For addi
6220: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
6230: 6f 6e 2c 20 73 65 65 20 0a 23 20 3c 61 20 68 72  on, see .# <a hr
6240: 65 66 3d 22 63 6f 6e 66 6c 69 63 74 2e 68 74 6d  ef="conflict.htm
6250: 6c 22 3e 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c  l">conflict.html
6260: 3c 2f 61 3e 2e 3c 2f 70 3e 0a 0a 0a 53 65 63 74  </a>.</p>...Sect
6270: 69 6f 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d  ion PRAGMA pragm
6280: 61 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  a..Syntax {sql-s
6290: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47  tatement} {.PRAG
62a0: 4d 41 20 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c  MA <name> = <val
62b0: 75 65 3e 20 7c 0a 50 52 41 47 4d 41 20 3c 66 75  ue> |.PRAGMA <fu
62c0: 6e 63 74 69 6f 6e 3e 28 3c 61 72 67 3e 29 0a 7d  nction>(<arg>).}
62d0: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
62e0: 50 52 41 47 4d 41 20 63 6f 6d 6d 61 6e 64 20 69  PRAGMA command i
62f0: 73 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79  s used to modify
6300: 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f   the operation o
6310: 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62  f the SQLite lib
6320: 72 61 72 79 2e 0a 54 68 65 20 70 72 61 67 6d 61  rary..The pragma
6330: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65 78 70 65   command is expe
6340: 72 69 6d 65 6e 74 61 6c 20 61 6e 64 20 73 70 65  rimental and spe
6350: 63 69 66 69 63 20 70 72 61 67 6d 61 20 73 74 61  cific pragma sta
6360: 74 65 6d 65 6e 74 73 20 6d 61 79 0a 72 65 6d 6f  tements may.remo
6370: 76 65 64 20 6f 72 20 61 64 64 65 64 20 69 6e 20  ved or added in 
6380: 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 20  future releases 
6390: 6f 66 20 53 51 4c 69 74 65 2e 20 20 55 73 65 20  of SQLite.  Use 
63a0: 74 68 69 73 20 63 6f 6d 6d 61 6e 64 0a 77 69 74  this command.wit
63b0: 68 20 63 61 75 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  h caution.</p>..
63c0: 3c 70 3e 54 68 65 20 63 75 72 72 65 6e 74 20 69  <p>The current i
63d0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 75  mplementation su
63e0: 70 70 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f  pports the follo
63f0: 77 69 6e 67 20 70 72 61 67 6d 61 73 3a 3c 2f 70  wing pragmas:</p
6400: 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c  >..<ul>.<li><p><
6410: 62 3e 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73  b>PRAGMA cache_s
6420: 69 7a 65 20 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d  ize = </b><i>Num
6430: 62 65 72 2d 6f 66 2d 70 61 67 65 73 3c 2f 69 3e  ber-of-pages</i>
6440: 3c 62 3e 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  <b>;</b></p>.   
6450: 20 3c 70 3e 43 68 61 6e 67 65 20 74 68 65 20 6d   <p>Change the m
6460: 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  aximum number of
6470: 20 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 70   database disk p
6480: 61 67 65 73 20 74 68 61 74 20 53 51 4c 69 74 65  ages that SQLite
6490: 0a 20 20 20 20 77 69 6c 6c 20 68 6f 6c 64 20 69  .    will hold i
64a0: 6e 20 6d 65 6d 6f 72 79 20 61 74 20 6f 6e 63 65  n memory at once
64b0: 2e 20 20 45 61 63 68 20 70 61 67 65 20 75 73 65  .  Each page use
64c0: 73 20 61 62 6f 75 74 20 31 2e 35 4b 20 6f 66 20  s about 1.5K of 
64d0: 52 41 4d 2e 0a 20 20 20 20 54 68 65 20 64 65 66  RAM..    The def
64e0: 61 75 6c 74 20 63 61 63 68 65 20 73 69 7a 65 20  ault cache size 
64f0: 69 73 20 31 30 30 2e 20 20 49 66 20 79 6f 75 20  is 100.  If you 
6500: 61 72 65 20 64 6f 69 6e 67 20 55 50 44 41 54 45  are doing UPDATE
6510: 73 20 6f 72 20 44 45 4c 45 54 45 73 0a 20 20 20  s or DELETEs.   
6520: 20 74 68 61 74 20 63 68 61 6e 67 65 20 6d 61 6e   that change man
6530: 79 20 72 6f 77 73 20 6f 66 20 61 20 64 61 74 61  y rows of a data
6540: 62 61 73 65 20 61 6e 64 20 79 6f 75 20 64 6f 20  base and you do 
6550: 6e 6f 74 20 6d 69 6e 64 20 69 66 20 53 51 4c 69  not mind if SQLi
6560: 74 65 0a 20 20 20 20 75 73 65 73 20 6d 6f 72 65  te.    uses more
6570: 20 6d 65 6d 6f 72 79 2c 20 79 6f 75 20 63 61 6e   memory, you can
6580: 20 69 6e 63 72 65 61 73 65 20 74 68 65 20 63 61   increase the ca
6590: 63 68 65 20 73 69 7a 65 20 66 6f 72 20 61 20 70  che size for a p
65a0: 6f 73 73 69 62 6c 65 20 73 70 65 65 64 0a 20 20  ossible speed.  
65b0: 20 20 69 6d 70 72 6f 76 65 6d 65 6e 74 2e 3c 2f    improvement.</
65c0: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
65d0: 3c 62 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f  <b>PRAGMA count_
65e0: 63 68 61 6e 67 65 73 20 3d 20 4f 4e 3b 0a 20 20  changes = ON;.  
65f0: 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20       <br>PRAGMA 
6600: 63 6f 75 6e 74 5f 63 68 61 6e 67 65 73 20 3d 20  count_changes = 
6610: 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  OFF;</b></p>.   
6620: 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68 65   <p>When on, the
6630: 20 43 4f 55 4e 54 5f 43 48 41 4e 47 45 53 20 70   COUNT_CHANGES p
6640: 72 61 67 6d 61 20 63 61 75 73 65 73 20 74 68 65  ragma causes the
6650: 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69   callback functi
6660: 6f 6e 20 74 6f 0a 20 20 20 20 62 65 20 69 6e 76  on to.    be inv
6670: 6f 6b 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61  oked once for ea
6680: 63 68 20 44 45 4c 45 54 45 2c 20 49 4e 53 45 52  ch DELETE, INSER
6690: 54 2c 20 6f 72 20 55 50 44 41 54 45 20 6f 70 65  T, or UPDATE ope
66a0: 72 61 74 69 6f 6e 2e 20 20 54 68 65 0a 20 20 20  ration.  The.   
66b0: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65   argument is the
66c0: 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20   number of rows 
66d0: 74 68 61 74 20 77 65 72 65 20 63 68 61 6e 67 65  that were change
66e0: 64 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c  d.</p>..<li><p><
66f0: 62 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72  b>PRAGMA empty_r
6700: 65 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20  esult_callbacks 
6710: 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72  = ON;.       <br
6720: 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65  >PRAGMA empty_re
6730: 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d  sult_callbacks =
6740: 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20   OFF;</b></p>.  
6750: 20 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68    <p>When on, th
6760: 65 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43  e EMPTY_RESULT_C
6770: 41 4c 4c 42 41 43 4b 53 20 70 72 61 67 6d 61 20  ALLBACKS pragma 
6780: 63 61 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62  causes the callb
6790: 61 63 6b 0a 20 20 20 20 66 75 6e 63 74 69 6f 6e  ack.    function
67a0: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f   to be invoked o
67b0: 6e 63 65 20 66 6f 72 20 65 61 63 68 20 71 75 65  nce for each que
67c0: 72 79 20 74 68 61 74 20 68 61 73 20 61 6e 20 65  ry that has an e
67d0: 6d 70 74 79 20 72 65 73 75 6c 74 0a 20 20 20 20  mpty result.    
67e0: 73 65 74 2e 20 20 54 68 65 20 74 68 69 72 64 20  set.  The third 
67f0: 22 3c 62 3e 61 72 67 76 3c 2f 62 3e 22 20 70 61  "<b>argv</b>" pa
6800: 72 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20 63  rameter to the c
6810: 61 6c 6c 62 61 63 6b 20 69 73 20 73 65 74 20 74  allback is set t
6820: 6f 20 4e 55 4c 4c 0a 20 20 20 20 62 65 63 61 75  o NULL.    becau
6830: 73 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64  se there is no d
6840: 61 74 61 20 74 6f 20 72 65 70 6f 72 74 2e 20 20  ata to report.  
6850: 42 75 74 20 74 68 65 20 73 65 63 6f 6e 64 20 22  But the second "
6860: 3c 62 3e 61 72 67 63 3c 2f 62 3e 22 20 61 6e 64  <b>argc</b>" and
6870: 0a 20 20 20 20 66 6f 75 72 74 68 20 22 3c 62 3e  .    fourth "<b>
6880: 63 6f 6c 75 6d 6e 4e 61 6d 65 73 3c 2f 62 3e 22  columnNames</b>"
6890: 20 70 61 72 61 6d 65 74 65 72 73 20 61 72 65 20   parameters are 
68a0: 76 61 6c 69 64 20 61 6e 64 20 63 61 6e 20 62 65  valid and can be
68b0: 20 75 73 65 64 20 74 6f 0a 20 20 20 20 64 65 74   used to.    det
68c0: 65 72 6d 69 6e 65 20 74 68 65 20 6e 75 6d 62 65  ermine the numbe
68d0: 72 20 61 6e 64 20 6e 61 6d 65 73 20 6f 66 20 74  r and names of t
68e0: 68 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20  he columns that 
68f0: 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20  would have been 
6900: 69 6e 0a 20 20 20 20 74 68 65 20 72 65 73 75 6c  in.    the resul
6910: 74 20 73 65 74 20 68 61 64 20 74 68 65 20 73 65  t set had the se
6920: 74 20 6e 6f 74 20 62 65 65 6e 20 65 6d 70 74 79  t not been empty
6930: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
6940: 3e 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f 6c  >PRAGMA full_col
6950: 75 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 4e 3b 0a  umn_names = ON;.
6960: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
6970: 41 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61  A full_column_na
6980: 6d 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f  mes = OFF;</b></
6990: 70 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f  p>.    <p>The co
69a0: 6c 75 6d 6e 20 6e 61 6d 65 73 20 72 65 70 6f 72  lumn names repor
69b0: 74 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65  ted in an SQLite
69c0: 20 63 61 6c 6c 62 61 63 6b 20 61 72 65 20 6e 6f   callback are no
69d0: 72 6d 61 6c 6c 79 20 6a 75 73 74 0a 20 20 20 20  rmally just.    
69e0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
69f0: 63 6f 6c 75 6d 6e 20 69 74 73 65 6c 66 2c 20 65  column itself, e
6a00: 78 63 65 70 74 20 66 6f 72 20 6a 6f 69 6e 73 20  xcept for joins 
6a10: 77 68 65 6e 20 22 54 41 42 4c 45 2e 43 4f 4c 55  when "TABLE.COLU
6a20: 4d 4e 22 0a 20 20 20 20 69 73 20 75 73 65 64 2e  MN".    is used.
6a30: 20 20 42 75 74 20 77 68 65 6e 20 66 75 6c 6c 5f    But when full_
6a40: 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 69 73 20  column_names is 
6a50: 74 75 72 6e 65 64 20 6f 6e 2c 20 63 6f 6c 75 6d  turned on, colum
6a60: 6e 20 6e 61 6d 65 73 20 61 72 65 0a 20 20 20 20  n names are.    
6a70: 61 6c 77 61 79 73 20 72 65 70 6f 72 74 65 64 20  always reported 
6a80: 61 73 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e  as "TABLE.COLUMN
6a90: 22 20 65 76 65 6e 20 66 6f 72 20 73 69 6d 70 6c  " even for simpl
6aa0: 65 20 71 75 65 72 69 65 73 2e 3c 2f 70 3e 3c 2f  e queries.</p></
6ab0: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50  li>..<li><p><b>P
6ac0: 52 41 47 4d 41 20 69 6e 64 65 78 5f 69 6e 66 6f  RAGMA index_info
6ad0: 28 3c 2f 62 3e 3c 69 3e 69 6e 64 65 78 2d 6e 61  (</b><i>index-na
6ae0: 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c  me</i><b>);</b><
6af0: 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65  /p>.    <p>For e
6b00: 61 63 68 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20  ach column that 
6b10: 74 68 65 20 6e 61 6d 65 64 20 69 6e 64 65 78 20  the named index 
6b20: 72 65 66 65 72 65 6e 63 65 73 2c 20 69 6e 76 6f  references, invo
6b30: 6b 65 20 74 68 65 20 0a 20 20 20 20 63 61 6c 6c  ke the .    call
6b40: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20  back function.  
6b50: 20 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f    once with info
6b60: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68  rmation about th
6b70: 61 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75  at column, inclu
6b80: 64 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ding the column 
6b90: 6e 61 6d 65 2c 0a 20 20 20 20 61 6e 64 20 74 68  name,.    and th
6ba0: 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 2e  e column number.
6bb0: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
6bc0: 50 52 41 47 4d 41 20 69 6e 64 65 78 5f 6c 69 73  PRAGMA index_lis
6bd0: 74 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e  t(</b><i>table-n
6be0: 61 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e  ame</i><b>);</b>
6bf0: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20  </p>.    <p>For 
6c00: 65 61 63 68 20 69 6e 64 65 78 20 6f 6e 20 74 68  each index on th
6c10: 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69  e named table, i
6c20: 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61  nvoke the callba
6c30: 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20  ck function.    
6c40: 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d  once with inform
6c50: 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74  ation about that
6c60: 20 69 6e 64 65 78 2e 20 20 41 72 67 75 6d 65 6e   index.  Argumen
6c70: 74 73 20 69 6e 63 6c 75 64 65 20 74 68 65 0a 20  ts include the. 
6c80: 20 20 20 69 6e 64 65 78 20 6e 61 6d 65 20 61 6e     index name an
6c90: 64 20 61 20 66 6c 61 67 20 74 6f 20 69 6e 64 69  d a flag to indi
6ca0: 63 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20  cate whether or 
6cb0: 6e 6f 74 20 74 68 65 20 69 6e 64 65 78 20 6d 75  not the index mu
6cc0: 73 74 20 62 65 0a 20 20 20 20 75 6e 69 71 75 65  st be.    unique
6cd0: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
6ce0: 3e 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74  >PRAGMA parser_t
6cf0: 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52  race = ON;<br>PR
6d00: 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72 61 63  AGMA parser_trac
6d10: 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e  e = OFF;</b></p>
6d20: 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61  .    <p>Turn tra
6d30: 63 69 6e 67 20 6f 66 20 74 68 65 20 53 51 4c 20  cing of the SQL 
6d40: 70 61 72 73 65 72 20 69 6e 73 69 64 65 20 6f 66  parser inside of
6d50: 20 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20   the.    SQLite 
6d60: 6c 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f  library on and o
6d70: 66 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65  ff.  This is use
6d80: 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e  d for debugging.
6d90: 0a 20 20 20 20 54 68 69 73 20 6f 6e 6c 79 20 77  .    This only w
6da0: 6f 72 6b 73 20 69 66 20 74 68 65 20 6c 69 62 72  orks if the libr
6db0: 61 72 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20  ary is compiled 
6dc0: 77 69 74 68 6f 75 74 20 74 68 65 20 4e 44 45 42  without the NDEB
6dd0: 55 47 20 6d 61 63 72 6f 2e 0a 20 20 20 20 3c 2f  UG macro..    </
6de0: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
6df0: 3c 62 3e 50 52 41 47 4d 41 20 73 61 6e 69 74 79  <b>PRAGMA sanity
6e00: 5f 63 68 65 63 6b 3b 3c 2f 62 3e 3c 2f 70 3e 0a  _check;</b></p>.
6e10: 20 20 20 20 3c 70 3e 54 68 65 20 63 6f 6d 6d 61      <p>The comma
6e20: 6e 64 20 64 6f 65 73 20 61 6e 20 69 6e 74 65 67  nd does an integ
6e30: 72 69 74 79 20 63 68 65 63 6b 20 6f 66 20 74 68  rity check of th
6e40: 65 20 65 6e 74 69 72 65 20 64 61 74 61 62 61 73  e entire databas
6e50: 65 2e 20 20 49 74 0a 20 20 20 20 6c 6f 6f 6b 73  e.  It.    looks
6e60: 20 66 6f 72 20 6f 75 74 2d 6f 66 2d 6f 72 64 65   for out-of-orde
6e70: 72 20 72 65 63 6f 72 64 73 2c 20 6d 69 73 73 69  r records, missi
6e80: 6e 67 20 70 61 67 65 73 2c 20 61 6e 64 20 6d 61  ng pages, and ma
6e90: 6c 66 6f 72 6d 65 64 20 72 65 63 6f 72 64 73 2e  lformed records.
6ea0: 0a 20 20 20 20 49 66 20 61 6e 79 20 70 72 6f 62  .    If any prob
6eb0: 6c 65 6d 73 20 61 72 65 20 66 6f 75 6e 64 2c 20  lems are found, 
6ec0: 74 68 65 6e 20 61 20 73 69 6e 67 6c 65 20 73 74  then a single st
6ed0: 72 69 6e 67 20 69 73 20 72 65 74 75 72 6e 65 64  ring is returned
6ee0: 20 77 68 69 63 68 20 69 73 0a 20 20 20 20 61 20   which is.    a 
6ef0: 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 61  description of a
6f00: 6c 6c 20 70 72 6f 62 6c 65 6d 73 2e 20 20 49 66  ll problems.  If
6f10: 20 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 69   everything is i
6f20: 6e 20 6f 72 64 65 72 2c 20 22 6f 6b 22 20 69 73  n order, "ok" is
6f30: 0a 20 20 20 20 72 65 74 75 72 6e 65 64 2e 20 20  .    returned.  
6f40: 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20  This command is 
6f50: 75 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e 67  used for testing
6f60: 20 61 6e 64 20 64 65 62 75 67 67 69 6e 67 20 6f   and debugging o
6f70: 6e 6c 79 20 61 6e 64 0a 20 20 20 20 69 73 20 6e  nly and.    is n
6f80: 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 69 66 20  ot available if 
6f90: 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 63  the library is c
6fa0: 6f 6d 70 69 6c 65 64 20 0a 20 20 20 20 77 69 74  ompiled .    wit
6fb0: 68 20 74 68 65 20 2d 44 4e 44 45 42 55 47 3d 31  h the -DNDEBUG=1
6fc0: 20 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6f 6e   compiler option
6fd0: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
6fe0: 3e 50 52 41 47 4d 41 20 74 61 62 6c 65 5f 69 6e  >PRAGMA table_in
6ff0: 66 6f 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d  fo(</b><i>table-
7000: 6e 61 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62  name</i><b>);</b
7010: 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72  ></p>.    <p>For
7020: 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 69 6e 20   each column in 
7030: 74 68 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c  the named table,
7040: 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c   invoke the call
7050: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20  back function.  
7060: 20 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f    once with info
7070: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68  rmation about th
7080: 61 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75  at column, inclu
7090: 64 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ding the column 
70a0: 6e 61 6d 65 2c 0a 20 20 20 20 64 61 74 61 20 74  name,.    data t
70b0: 79 70 65 2c 20 77 68 65 74 68 65 72 20 6f 72 20  ype, whether or 
70c0: 6e 6f 74 20 74 68 65 20 63 6f 6c 75 6d 6e 20 63  not the column c
70d0: 61 6e 20 62 65 20 4e 55 4c 4c 2c 20 61 6e 64 20  an be NULL, and 
70e0: 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 20 20  the default.    
70f0: 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20 63 6f  value for the co
7100: 6c 75 6d 6e 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c  lumn.</p>..<li><
7110: 70 3e 3c 62 3e 50 52 41 47 4d 41 20 76 64 62 65  p><b>PRAGMA vdbe
7120: 5f 74 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e  _trace = ON;<br>
7130: 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61 63  PRAGMA vdbe_trac
7140: 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e  e = OFF;</b></p>
7150: 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61  .    <p>Turn tra
7160: 63 69 6e 67 20 6f 66 20 74 68 65 20 76 69 72 74  cing of the virt
7170: 75 61 6c 20 64 61 74 61 62 61 73 65 20 65 6e 67  ual database eng
7180: 69 6e 65 20 69 6e 73 69 64 65 20 6f 66 20 74 68  ine inside of th
7190: 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c 69 62  e.    SQLite lib
71a0: 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66 66 2e  rary on and off.
71b0: 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 66    This is used f
71c0: 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 3c 2f 70  or debugging.</p
71d0: 3e 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70  ></li>.</ul>..<p
71e0: 3e 4e 6f 20 65 72 72 6f 72 20 6d 65 73 73 61 67  >No error messag
71f0: 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 69  e is generated i
7200: 66 20 61 6e 20 75 6e 6b 6e 6f 77 6e 20 70 72 61  f an unknown pra
7210: 67 6d 61 20 69 73 20 69 73 73 75 65 64 2e 0a 55  gma is issued..U
7220: 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 73 20 61  nknown pragmas a
7230: 72 65 20 69 67 6e 6f 72 65 64 2e 3c 2f 70 3e 0a  re ignored.</p>.
7240: 7d 0a 0a 53 65 63 74 69 6f 6e 20 52 45 50 4c 41  }..Section REPLA
7250: 43 45 20 72 65 70 6c 61 63 65 0a 0a 53 79 6e 74  CE replace..Synt
7260: 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e  ax {sql-statemen
7270: 74 7d 20 7b 0a 52 45 50 4c 41 43 45 20 49 4e 54  t} {.REPLACE INT
7280: 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b  O <table-name> [
7290: 28 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20  ( <column-list> 
72a0: 29 5d 20 56 41 4c 55 45 53 20 28 20 3c 76 61 6c  )] VALUES ( <val
72b0: 75 65 2d 6c 69 73 74 3e 20 29 20 7c 0a 52 45 50  ue-list> ) |.REP
72c0: 4c 41 43 45 20 49 4e 54 4f 20 3c 74 61 62 6c 65  LACE INTO <table
72d0: 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63 6f 6c 75 6d  -name> [( <colum
72e0: 6e 2d 6c 69 73 74 3e 20 29 5d 20 3c 73 65 6c 65  n-list> )] <sele
72f0: 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d 0a  ct-statement>.}.
7300: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 52  .puts {.<p>The R
7310: 45 50 4c 41 43 45 20 63 6f 6d 6d 61 6e 64 20 69  EPLACE command i
7320: 73 20 61 6e 20 61 6c 69 61 73 20 66 6f 72 20 74  s an alias for t
7330: 68 65 20 22 49 4e 53 45 52 54 20 4f 52 20 52 45  he "INSERT OR RE
7340: 50 4c 41 43 45 22 20 76 61 72 69 61 6e 74 0a 6f  PLACE" variant.o
7350: 66 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 23  f the <a href="#
7360: 69 6e 73 65 72 74 22 3e 49 4e 53 45 52 54 20 63  insert">INSERT c
7370: 6f 6d 6d 61 6e 64 3c 2f 61 3e 2e 20 20 54 68 69  ommand</a>.  Thi
7380: 73 20 61 6c 69 61 73 20 69 73 20 70 72 6f 76 69  s alias is provi
7390: 64 65 64 20 66 6f 72 0a 63 6f 6d 70 61 74 69 62  ded for.compatib
73a0: 69 6c 69 74 79 20 77 69 74 68 20 4d 79 53 51 4c  ility with MySQL
73b0: 2e 20 20 53 65 65 20 74 68 65 20 0a 3c 61 20 68  .  See the .<a h
73c0: 72 65 66 3d 22 23 69 6e 73 65 72 74 22 3e 49 4e  ref="#insert">IN
73d0: 53 45 52 54 20 63 6f 6d 6d 61 6e 64 3c 2f 61 3e  SERT command</a>
73e0: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66   documentation f
73f0: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 0a 69 6e  or additional.in
7400: 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 20 20  formation.</p>  
7410: 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 53 45 4c 45  .}..Section SELE
7420: 43 54 20 73 65 6c 65 63 74 0a 0a 53 79 6e 74 61  CT select..Synta
7430: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
7440: 7d 20 7b 0a 53 45 4c 45 43 54 20 3c 72 65 73 75  } {.SELECT <resu
7450: 6c 74 3e 20 46 52 4f 4d 20 3c 74 61 62 6c 65 2d  lt> FROM <table-
7460: 6c 69 73 74 3e 20 0a 5b 57 48 45 52 45 20 3c 65  list> .[WHERE <e
7470: 78 70 72 65 73 73 69 6f 6e 3e 5d 0a 5b 47 52 4f  xpression>].[GRO
7480: 55 50 20 42 59 20 3c 65 78 70 72 2d 6c 69 73 74  UP BY <expr-list
7490: 3e 5d 0a 5b 48 41 56 49 4e 47 20 3c 65 78 70 72  >].[HAVING <expr
74a0: 65 73 73 69 6f 6e 3e 5d 0a 5b 3c 63 6f 6d 70 6f  ession>].[<compo
74b0: 75 6e 64 2d 6f 70 3e 20 3c 73 65 6c 65 63 74 3e  und-op> <select>
74c0: 5d 2a 0a 5b 4f 52 44 45 52 20 42 59 20 3c 73 6f  ]*.[ORDER BY <so
74d0: 72 74 2d 65 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b  rt-expr-list>].[
74e0: 4c 49 4d 49 54 20 3c 69 6e 74 65 67 65 72 3e 20  LIMIT <integer> 
74f0: 5b 4f 46 46 53 45 54 20 3c 69 6e 74 65 67 65 72  [OFFSET <integer
7500: 3e 5d 5d 0a 7d 20 7b 72 65 73 75 6c 74 7d 20 7b  >]].} {result} {
7510: 0a 53 54 41 52 20 7c 20 3c 72 65 73 75 6c 74 2d  .STAR | <result-
7520: 63 6f 6c 75 6d 6e 3e 20 5b 2c 20 3c 72 65 73 75  column> [, <resu
7530: 6c 74 2d 63 6f 6c 75 6d 6e 3e 5d 2a 0a 7d 20 7b  lt-column>]*.} {
7540: 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 7d 20 7b  result-column} {
7550: 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 5b 20  .<expression> [ 
7560: 5b 41 53 5d 20 3c 73 74 72 69 6e 67 3e 20 5d 0a  [AS] <string> ].
7570: 7d 20 7b 74 61 62 6c 65 2d 6c 69 73 74 7d 20 7b  } {table-list} {
7580: 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 2c  .<table-name> [,
7590: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 5d 2a 0a   <table-name>]*.
75a0: 7d 20 7b 73 6f 72 74 2d 65 78 70 72 2d 6c 69 73  } {sort-expr-lis
75b0: 74 7d 20 7b 0a 3c 65 78 70 72 3e 20 5b 3c 73 6f  t} {.<expr> [<so
75c0: 72 74 2d 6f 72 64 65 72 3e 5d 20 5b 2c 20 3c 65  rt-order>] [, <e
75d0: 78 70 72 3e 20 5b 3c 73 6f 72 74 2d 6f 72 64 65  xpr> [<sort-orde
75e0: 72 3e 5d 5d 2a 0a 7d 20 7b 73 6f 72 74 2d 6f 72  r>]]*.} {sort-or
75f0: 64 65 72 7d 20 7b 0a 41 53 43 20 7c 20 44 45 53  der} {.ASC | DES
7600: 43 0a 7d 20 7b 63 6f 6d 70 6f 75 6e 64 5f 6f 70  C.} {compound_op
7610: 7d 20 7b 0a 55 4e 49 4f 4e 20 7c 20 55 4e 49 4f  } {.UNION | UNIO
7620: 4e 20 41 4c 4c 20 7c 20 49 4e 54 45 52 53 45 43  N ALL | INTERSEC
7630: 54 20 7c 20 45 58 43 45 50 54 0a 7d 0a 0a 70 75  T | EXCEPT.}..pu
7640: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 53 45 4c 45  ts {.<p>The SELE
7650: 43 54 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20  CT statement is 
7660: 75 73 65 64 20 74 6f 20 71 75 65 72 79 20 74 68  used to query th
7670: 65 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 65  e database.  The
7680: 0a 72 65 73 75 6c 74 20 6f 66 20 61 20 53 45 4c  .result of a SEL
7690: 45 43 54 20 69 73 20 7a 65 72 6f 20 6f 72 20 6d  ECT is zero or m
76a0: 6f 72 65 20 72 6f 77 73 20 6f 66 20 64 61 74 61  ore rows of data
76b0: 20 77 68 65 72 65 20 65 61 63 68 20 72 6f 77 0a   where each row.
76c0: 68 61 73 20 61 20 66 69 78 65 64 20 6e 75 6d 62  has a fixed numb
76d0: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 2e 20 20  er of columns.  
76e0: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  The number of co
76f0: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 0a 72 65 73  lumns in the.res
7700: 75 6c 74 20 69 73 20 73 70 65 63 69 66 69 65 64  ult is specified
7710: 20 62 79 20 74 68 65 20 65 78 70 72 65 73 73 69   by the expressi
7720: 6f 6e 20 6c 69 73 74 20 69 6e 20 62 65 74 77 65  on list in betwe
7730: 65 6e 20 74 68 65 0a 53 45 4c 45 43 54 20 61 6e  en the.SELECT an
7740: 64 20 46 52 4f 4d 20 6b 65 79 77 6f 72 64 73 2e  d FROM keywords.
7750: 20 20 41 6e 79 20 61 72 62 69 74 72 61 72 79 20    Any arbitrary 
7760: 65 78 70 72 65 73 73 69 6f 6e 20 63 61 6e 20 62  expression can b
7770: 65 20 75 73 65 64 0a 61 73 20 61 20 72 65 73 75  e used.as a resu
7780: 6c 74 2e 20 20 49 66 20 74 68 65 20 72 65 73 75  lt.  If the resu
7790: 6c 74 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e  lt specification
77a0: 20 69 73 20 6a 75 73 74 7d 0a 70 75 74 73 20 22   is just}.puts "
77b0: 5b 4f 70 65 72 61 74 6f 72 20 2a 5d 20 74 68 65  [Operator *] the
77c0: 6e 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73 20 6f 66  n all columns of
77d0: 20 61 6c 6c 20 74 61 62 6c 65 73 20 61 72 65 20   all tables are 
77e0: 75 73 65 64 20 61 73 20 74 68 65 20 72 65 73 75  used as the resu
77f0: 6c 74 2e 22 0a 70 75 74 73 20 7b 3c 2f 70 3e 0a  lt.".puts {</p>.
7800: 0a 3c 70 3e 54 68 65 20 71 75 65 72 79 20 69 73  .<p>The query is
7810: 20 65 78 65 63 75 74 65 64 20 61 67 61 69 6e 20   executed again 
7820: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 61 62 6c  one or more tabl
7830: 65 73 20 73 70 65 63 69 66 69 65 64 20 61 66 74  es specified aft
7840: 65 72 0a 74 68 65 20 46 52 4f 4d 20 6b 65 79 77  er.the FROM keyw
7850: 6f 72 64 2e 20 20 49 66 20 6d 6f 72 65 20 74 68  ord.  If more th
7860: 61 6e 20 6f 6e 65 20 74 61 62 6c 65 20 69 73 20  an one table is 
7870: 73 70 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20  specified, then 
7880: 74 68 65 0a 71 75 65 72 79 20 69 73 20 61 67 61  the.query is aga
7890: 69 6e 73 74 20 74 68 65 20 6a 6f 69 6e 20 6f 66  inst the join of
78a0: 20 74 68 65 20 76 61 72 69 6f 75 73 20 74 61 62   the various tab
78b0: 6c 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  les.</p>..<p>The
78c0: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 63 61   WHERE clause ca
78d0: 6e 20 62 65 20 75 73 65 64 20 74 6f 20 6c 69 6d  n be used to lim
78e0: 69 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  it the number of
78f0: 20 72 6f 77 73 20 6f 76 65 72 0a 77 68 69 63 68   rows over.which
7900: 20 74 68 65 20 71 75 65 72 79 20 6f 70 65 72 61   the query opera
7910: 74 65 73 2e 20 20 49 6e 20 74 68 65 20 63 75 72  tes.  In the cur
7920: 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74  rent implementat
7930: 69 6f 6e 2c 0a 69 6e 64 69 63 65 73 20 77 69 6c  ion,.indices wil
7940: 6c 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 74  l only be used t
7950: 6f 0a 6f 70 74 69 6d 69 7a 65 20 74 68 65 20 71  o.optimize the q
7960: 75 65 72 79 20 69 66 20 57 48 45 52 45 20 65 78  uery if WHERE ex
7970: 70 72 65 73 73 69 6f 6e 20 63 6f 6e 74 61 69 6e  pression contain
7980: 73 20 65 71 75 61 6c 69 74 79 20 63 6f 6d 70 61  s equality compa
7990: 72 69 73 6f 6e 73 0a 63 6f 6e 6e 65 63 74 65 64  risons.connected
79a0: 20 62 79 20 74 68 65 20 41 4e 44 20 6f 70 65 72   by the AND oper
79b0: 61 74 6f 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  ator.</p>..<p>Th
79c0: 65 20 47 52 4f 55 50 20 42 59 20 63 6c 61 75 73  e GROUP BY claus
79d0: 65 73 20 63 61 75 73 65 73 20 6f 6e 65 20 6f 72  es causes one or
79e0: 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66 20 74 68   more rows of th
79f0: 65 20 72 65 73 75 6c 74 20 74 6f 0a 62 65 20 63  e result to.be c
7a00: 6f 6d 62 69 6e 65 64 20 69 6e 74 6f 20 61 20 73  ombined into a s
7a10: 69 6e 67 6c 65 20 72 6f 77 20 6f 66 20 6f 75 74  ingle row of out
7a20: 70 75 74 2e 20 20 54 68 69 73 20 69 73 20 65 73  put.  This is es
7a30: 70 65 63 69 61 6c 6c 79 20 75 73 65 66 75 6c 0a  pecially useful.
7a40: 77 68 65 6e 20 74 68 65 20 72 65 73 75 6c 74 20  when the result 
7a50: 63 6f 6e 74 61 69 6e 73 20 61 67 67 72 65 67 61  contains aggrega
7a60: 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54  te functions.  T
7a70: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 69  he expressions i
7a80: 6e 0a 74 68 65 20 47 52 4f 55 50 20 42 59 20 63  n.the GROUP BY c
7a90: 6c 61 75 73 65 20 64 6f 20 3c 65 6d 3e 6e 6f 74  lause do <em>not
7aa0: 3c 2f 65 6d 3e 20 68 61 76 65 20 74 6f 20 62 65  </em> have to be
7ab0: 20 65 78 70 72 65 73 73 69 6f 6e 73 20 74 68 61   expressions tha
7ac0: 74 0a 61 70 70 65 61 72 20 69 6e 20 74 68 65 20  t.appear in the 
7ad0: 72 65 73 75 6c 74 2e 20 20 54 68 65 20 48 41 56  result.  The HAV
7ae0: 49 4e 47 20 63 6c 61 75 73 65 20 69 73 20 73 69  ING clause is si
7af0: 6d 69 6c 61 72 20 74 6f 20 57 48 45 52 45 20 65  milar to WHERE e
7b00: 78 63 65 70 74 0a 74 68 61 74 20 48 41 56 49 4e  xcept.that HAVIN
7b10: 47 20 61 70 70 6c 69 65 73 20 61 66 74 65 72 20  G applies after 
7b20: 67 72 6f 75 70 69 6e 67 20 68 61 73 20 6f 63 63  grouping has occ
7b30: 75 72 72 65 64 2e 20 20 54 68 65 20 48 41 56 49  urred.  The HAVI
7b40: 4e 47 20 65 78 70 72 65 73 73 69 6f 6e 0a 6d 61  NG expression.ma
7b50: 79 20 72 65 66 65 72 20 74 6f 20 76 61 6c 75 65  y refer to value
7b60: 73 2c 20 65 76 65 6e 20 61 67 67 72 65 67 61 74  s, even aggregat
7b70: 65 20 66 75 6e 63 74 69 6f 6e 73 2c 20 74 68 61  e functions, tha
7b80: 74 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 68 65  t are not in the
7b90: 20 72 65 73 75 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70   result.</p>..<p
7ba0: 3e 54 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c  >The ORDER BY cl
7bb0: 61 75 73 65 20 63 61 75 73 65 73 20 74 68 65 20  ause causes the 
7bc0: 6f 75 74 70 75 74 20 72 6f 77 73 20 74 6f 20 62  output rows to b
7bd0: 65 20 73 6f 72 74 65 64 2e 20 20 0a 54 68 65 20  e sorted.  .The 
7be0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 4f 52 44 45  argument to ORDE
7bf0: 52 20 42 59 20 69 73 20 61 20 6c 69 73 74 20 6f  R BY is a list o
7c00: 66 20 65 78 70 72 65 73 73 69 6f 6e 73 20 74 68  f expressions th
7c10: 61 74 20 61 72 65 20 75 73 65 64 20 61 73 20 74  at are used as t
7c20: 68 65 0a 6b 65 79 20 66 6f 72 20 74 68 65 20 73  he.key for the s
7c30: 6f 72 74 2e 20 20 54 68 65 20 65 78 70 72 65 73  ort.  The expres
7c40: 73 69 6f 6e 73 20 64 6f 20 6e 6f 74 20 68 61 76  sions do not hav
7c50: 65 20 74 6f 20 62 65 20 70 61 72 74 20 6f 66 20  e to be part of 
7c60: 74 68 65 0a 72 65 73 75 6c 74 20 66 6f 72 20 61  the.result for a
7c70: 20 73 69 6d 70 6c 65 20 53 45 4c 45 43 54 2c 20   simple SELECT, 
7c80: 62 75 74 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e  but in a compoun
7c90: 64 20 53 45 4c 45 43 54 20 65 61 63 68 20 73 6f  d SELECT each so
7ca0: 72 74 0a 65 78 70 72 65 73 73 69 6f 6e 20 6d 75  rt.expression mu
7cb0: 73 74 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68  st exactly match
7cc0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 65 73 75   one of the resu
7cd0: 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20 20 45 61 63  lt columns.  Eac
7ce0: 68 0a 73 6f 72 74 20 65 78 70 72 65 73 73 69 6f  h.sort expressio
7cf0: 6e 20 6d 61 79 20 62 65 20 6f 70 74 69 6f 6e 61  n may be optiona
7d00: 6c 6c 79 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20  lly followed by 
7d10: 41 53 43 20 6f 72 20 44 45 53 43 20 74 6f 20 73  ASC or DESC to s
7d20: 70 65 63 69 66 79 0a 74 68 65 20 73 6f 72 74 20  pecify.the sort 
7d30: 6f 72 64 65 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  order.</p>..<p>T
7d40: 68 65 20 4c 49 4d 49 54 20 63 6c 61 75 73 65 20  he LIMIT clause 
7d50: 70 6c 61 63 65 73 20 61 6e 20 75 70 70 65 72 20  places an upper 
7d60: 62 6f 75 6e 64 20 6f 6e 20 74 68 65 20 6e 75 6d  bound on the num
7d70: 62 65 72 20 6f 66 20 72 6f 77 73 0a 72 65 74 75  ber of rows.retu
7d80: 72 6e 65 64 20 69 6e 20 74 68 65 20 72 65 73 75  rned in the resu
7d90: 6c 74 2e 20 20 41 20 4c 49 4d 49 54 20 6f 66 20  lt.  A LIMIT of 
7da0: 30 20 69 6e 64 69 63 61 74 65 73 20 6e 6f 20 75  0 indicates no u
7db0: 70 70 65 72 20 62 6f 75 6e 64 2e 0a 54 68 65 20  pper bound..The 
7dc0: 6f 70 74 69 6f 6e 61 6c 20 4f 46 46 53 45 54 20  optional OFFSET 
7dd0: 66 6f 6c 6c 6f 77 69 6e 67 20 4c 49 4d 49 54 20  following LIMIT 
7de0: 73 70 65 63 69 66 69 65 73 20 68 6f 77 20 6d 61  specifies how ma
7df0: 6e 79 0a 72 6f 77 73 20 74 6f 20 73 6b 69 70 20  ny.rows to skip 
7e00: 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67  at the beginning
7e10: 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 73   of the result s
7e20: 65 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 63 6f  et.</p>..<p>A co
7e30: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 20 69 73  mpound SELECT is
7e40: 20 66 6f 72 6d 65 64 20 66 72 6f 6d 20 74 77 6f   formed from two
7e50: 20 6f 72 20 6d 6f 72 65 20 73 69 6d 70 6c 65 20   or more simple 
7e60: 53 45 4c 45 43 54 73 20 63 6f 6e 6e 65 63 74 65  SELECTs connecte
7e70: 64 0a 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20  d.by one of the 
7e80: 6f 70 65 72 61 74 6f 72 73 20 55 4e 49 4f 4e 2c  operators UNION,
7e90: 20 55 4e 49 4f 4e 20 41 4c 4c 2c 20 49 4e 54 45   UNION ALL, INTE
7ea0: 52 53 45 43 54 2c 20 6f 72 20 45 58 43 45 50 54  RSECT, or EXCEPT
7eb0: 2e 20 20 49 6e 0a 61 20 63 6f 6d 70 6f 75 6e 64  .  In.a compound
7ec0: 20 53 45 4c 45 43 54 2c 20 61 6c 6c 20 74 68 65   SELECT, all the
7ed0: 20 63 6f 6e 73 74 69 74 75 65 6e 74 20 53 45 4c   constituent SEL
7ee0: 45 43 54 73 20 6d 75 73 74 20 73 70 65 63 69 66  ECTs must specif
7ef0: 79 20 74 68 65 0a 73 61 6d 65 20 6e 75 6d 62 65  y the.same numbe
7f00: 72 20 6f 66 20 72 65 73 75 6c 74 20 63 6f 6c 75  r of result colu
7f10: 6d 6e 73 2e 20 20 54 68 65 72 65 20 6d 61 79 20  mns.  There may 
7f20: 62 65 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65  be only a single
7f30: 20 4f 52 44 45 52 20 42 59 0a 63 6c 61 75 73 65   ORDER BY.clause
7f40: 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74   at the end of t
7f50: 68 65 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45  he compound SELE
7f60: 43 54 2e 20 20 54 68 65 20 55 4e 49 4f 4e 20 61  CT.  The UNION a
7f70: 6e 64 20 55 4e 49 4f 4e 20 41 4c 4c 0a 6f 70 65  nd UNION ALL.ope
7f80: 72 61 74 6f 72 73 20 63 6f 6d 62 69 6e 65 20 74  rators combine t
7f90: 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 74 68  he results of th
7fa0: 65 20 53 45 4c 45 43 54 73 20 74 6f 20 74 68 65  e SELECTs to the
7fb0: 20 72 69 67 68 74 20 61 6e 64 20 6c 65 66 74 20   right and left 
7fc0: 69 6e 74 6f 0a 61 20 73 69 6e 67 6c 65 20 62 69  into.a single bi
7fd0: 67 20 74 61 62 6c 65 2e 20 20 54 68 65 20 64 69  g table.  The di
7fe0: 66 66 65 72 65 6e 63 65 20 69 73 20 74 68 61 74  fference is that
7ff0: 20 69 6e 20 55 4e 49 4f 4e 20 61 6c 6c 20 72 65   in UNION all re
8000: 73 75 6c 74 20 72 6f 77 73 0a 61 72 65 20 64 69  sult rows.are di
8010: 73 74 69 6e 63 74 20 77 68 65 72 65 20 69 6e 20  stinct where in 
8020: 55 4e 49 4f 4e 20 41 4c 4c 20 74 68 65 72 65 20  UNION ALL there 
8030: 6d 61 79 20 62 65 20 64 75 70 6c 69 63 61 74 65  may be duplicate
8040: 73 2e 0a 54 68 65 20 49 4e 54 45 52 53 45 43 54  s..The INTERSECT
8050: 20 6f 70 65 72 61 74 6f 72 20 74 61 6b 65 73 20   operator takes 
8060: 74 68 65 20 69 6e 74 65 72 73 65 63 74 69 6f 6e  the intersection
8070: 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 73 20   of the results 
8080: 6f 66 20 74 68 65 0a 6c 65 66 74 20 61 6e 64 20  of the.left and 
8090: 72 69 67 68 74 20 53 45 4c 45 43 54 73 2e 20 20  right SELECTs.  
80a0: 45 58 43 45 50 54 20 74 61 6b 65 73 20 74 68 65  EXCEPT takes the
80b0: 20 72 65 73 75 6c 74 20 6f 66 20 6c 65 66 74 20   result of left 
80c0: 53 45 4c 45 43 54 20 61 66 74 65 72 0a 72 65 6d  SELECT after.rem
80d0: 6f 76 69 6e 67 20 74 68 65 20 72 65 73 75 6c 74  oving the result
80e0: 73 20 6f 66 20 74 68 65 20 72 69 67 68 74 20 53  s of the right S
80f0: 45 4c 45 43 54 2e 20 20 57 68 65 6e 20 74 68 72  ELECT.  When thr
8100: 65 65 20 61 72 65 20 6d 6f 72 65 20 53 45 4c 45  ee are more SELE
8110: 43 54 73 0a 61 72 65 20 63 6f 6e 6e 65 63 74 65  CTs.are connecte
8120: 64 20 69 6e 74 6f 20 61 20 63 6f 6d 70 6f 75 6e  d into a compoun
8130: 64 2c 20 74 68 65 79 20 67 72 6f 75 70 20 66 72  d, they group fr
8140: 6f 6d 20 6c 65 66 74 20 74 6f 20 72 69 67 68 74  om left to right
8150: 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
8160: 20 55 50 44 41 54 45 20 75 70 64 61 74 65 0a 0a   UPDATE update..
8170: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
8180: 65 6d 65 6e 74 7d 20 7b 0a 55 50 44 41 54 45 20  ement} {.UPDATE 
8190: 5b 20 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61  [ OR <conflict-a
81a0: 6c 67 6f 72 69 74 68 6d 3e 20 5d 20 3c 74 61 62  lgorithm> ] <tab
81b0: 6c 65 2d 6e 61 6d 65 3e 0a 53 45 54 20 3c 61 73  le-name>.SET <as
81c0: 73 69 67 6e 6d 65 6e 74 3e 20 5b 2c 20 3c 61 73  signment> [, <as
81d0: 73 69 67 6e 6d 65 6e 74 3e 5d 20 0a 5b 57 48 45  signment>] .[WHE
81e0: 52 45 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 5d  RE <expression>]
81f0: 0a 7d 20 7b 61 73 73 69 67 6e 6d 65 6e 74 7d 20  .} {assignment} 
8200: 7b 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20  {.<column-name> 
8210: 3d 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e 0a 7d  = <expression>.}
8220: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
8230: 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74  UPDATE statement
8240: 20 69 73 20 75 73 65 64 20 74 6f 20 63 68 61 6e   is used to chan
8250: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
8260: 63 6f 6c 75 6d 6e 73 20 69 6e 20 0a 73 65 6c 65  columns in .sele
8270: 63 74 65 64 20 72 6f 77 73 20 6f 66 20 61 20 74  cted rows of a t
8280: 61 62 6c 65 2e 20 20 45 61 63 68 20 61 73 73 69  able.  Each assi
8290: 67 6e 6d 65 6e 74 20 69 6e 20 61 6e 20 55 50 44  gnment in an UPD
82a0: 41 54 45 20 73 70 65 63 69 66 69 65 73 0a 61 20  ATE specifies.a 
82b0: 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 74 6f 20 74  column name to t
82c0: 68 65 20 6c 65 66 74 20 6f 66 20 74 68 65 20 65  he left of the e
82d0: 71 75 61 6c 73 20 73 69 67 6e 20 61 6e 64 20 61  quals sign and a
82e0: 6e 20 61 72 62 69 74 72 61 72 79 20 65 78 70 72  n arbitrary expr
82f0: 65 73 73 69 6f 6e 0a 74 6f 20 74 68 65 20 72 69  ession.to the ri
8300: 67 68 74 2e 20 20 54 68 65 20 65 78 70 72 65 73  ght.  The expres
8310: 73 69 6f 6e 73 20 6d 61 79 20 75 73 65 20 74 68  sions may use th
8320: 65 20 76 61 6c 75 65 73 20 6f 66 20 6f 74 68 65  e values of othe
8330: 72 20 63 6f 6c 75 6d 6e 73 2e 0a 41 6c 6c 20 65  r columns..All e
8340: 78 70 72 65 73 73 69 6f 6e 73 20 61 72 65 20 65  xpressions are e
8350: 76 61 6c 75 61 74 65 64 20 62 65 66 6f 72 65 20  valuated before 
8360: 61 6e 79 20 61 73 73 69 67 6e 6d 65 6e 74 73 20  any assignments 
8370: 61 72 65 20 6d 61 64 65 2e 0a 41 20 57 48 45 52  are made..A WHER
8380: 45 20 63 6c 61 75 73 65 20 63 61 6e 20 62 65 20  E clause can be 
8390: 75 73 65 64 20 74 6f 20 72 65 73 74 72 69 63 74  used to restrict
83a0: 20 77 68 69 63 68 20 72 6f 77 73 20 61 72 65 20   which rows are 
83b0: 75 70 64 61 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70  updated.</p>..<p
83c0: 3e 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f  >The optional co
83d0: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 20 61 6c  nflict-clause al
83e0: 6c 6f 77 73 20 74 68 65 20 73 70 65 63 69 66 69  lows the specifi
83f0: 63 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61 6c 74  cation of an alt
8400: 65 72 6e 61 74 69 76 65 0a 63 6f 6e 73 74 72 61  ernative.constra
8410: 69 6e 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73  int conflict res
8420: 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  olution algorith
8430: 6d 20 74 6f 20 75 73 65 20 64 75 72 69 6e 67 20  m to use during 
8440: 74 68 69 73 20 6f 6e 65 20 63 6f 6d 6d 61 6e 64  this one command
8450: 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74 69 6f  ..See the sectio
8460: 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72 65 66  n titled.<a href
8470: 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20  ="#conflict">ON 
8480: 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66 6f 72  CONFLICT</a> for
8490: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   additional info
84a0: 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 7d 0a 0a  rmation.</p>.}..
84b0: 53 65 63 74 69 6f 6e 20 56 41 43 55 55 4d 20 76  Section VACUUM v
84c0: 61 63 75 75 6d 0a 0a 53 79 6e 74 61 78 20 7b 73  acuum..Syntax {s
84d0: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
84e0: 56 41 43 55 55 4d 20 5b 3c 69 6e 64 65 78 2d 6f  VACUUM [<index-o
84f0: 72 2d 74 61 62 6c 65 2d 6e 61 6d 65 3e 5d 0a 7d  r-table-name>].}
8500: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
8510: 56 41 43 55 55 4d 20 63 6f 6d 6d 61 6e 64 20 69  VACUUM command i
8520: 73 20 61 6e 20 53 51 4c 69 74 65 20 65 78 74 65  s an SQLite exte
8530: 6e 73 69 6f 6e 20 6d 6f 64 65 6c 6c 65 64 20 61  nsion modelled a
8540: 66 74 65 72 20 61 20 73 69 6d 69 6c 61 72 0a 63  fter a similar.c
8550: 6f 6d 6d 61 6e 64 20 66 6f 75 6e 64 20 69 6e 20  ommand found in 
8560: 50 6f 73 74 67 72 65 53 51 4c 2e 20 20 49 66 20  PostgreSQL.  If 
8570: 56 41 43 55 55 4d 20 69 73 20 69 6e 76 6f 6b 65  VACUUM is invoke
8580: 64 20 77 69 74 68 20 74 68 65 20 6e 61 6d 65 20  d with the name 
8590: 6f 66 20 61 0a 74 61 62 6c 65 20 6f 72 20 69 6e  of a.table or in
85a0: 64 65 78 20 74 68 65 6e 20 69 74 20 69 73 20 73  dex then it is s
85b0: 75 70 70 6f 73 65 20 74 6f 20 63 6c 65 61 6e 20  uppose to clean 
85c0: 75 70 20 74 68 65 20 6e 61 6d 65 64 20 74 61 62  up the named tab
85d0: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 0a 49 6e 20  le or index..In 
85e0: 76 65 72 73 69 6f 6e 20 31 2e 30 20 6f 66 20 53  version 1.0 of S
85f0: 51 4c 69 74 65 2c 20 74 68 65 20 56 41 43 55 55  QLite, the VACUU
8600: 4d 20 63 6f 6d 6d 61 6e 64 20 77 6f 75 6c 64 20  M command would 
8610: 69 6e 76 6f 6b 65 20 0a 3c 62 3e 67 64 62 6d 5f  invoke .<b>gdbm_
8620: 72 65 6f 72 67 61 6e 69 7a 65 28 29 3c 2f 62 3e  reorganize()</b>
8630: 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 74 68 65   to clean up the
8640: 20 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73   backend databas
8650: 65 20 66 69 6c 65 2e 0a 42 65 67 69 6e 6e 69 6e  e file..Beginnin
8660: 67 20 77 69 74 68 20 76 65 72 73 69 6f 6e 20 32  g with version 2
8670: 2e 30 20 6f 66 20 53 51 4c 69 74 65 2c 20 47 44  .0 of SQLite, GD
8680: 42 4d 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20  BM is no longer 
8690: 75 73 65 64 20 66 6f 72 0a 74 68 65 20 64 61 74  used for.the dat
86a0: 61 62 61 73 65 20 62 61 63 6b 65 6e 64 20 61 6e  abase backend an
86b0: 64 20 56 41 43 55 55 4d 20 68 61 73 20 62 65 63  d VACUUM has bec
86c0: 6f 6d 65 20 61 20 6e 6f 2d 6f 70 2e 0a 3c 2f 70  ome a no-op..</p
86d0: 3e 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  >.}...puts {.<p>
86e0: 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 3c 61  <hr /></p>.<p><a
86f0: 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d   href="index.htm
8700: 6c 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67 6f  l"><img src="/go
8710: 62 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65 72  back.jpg" border
8720: 3d 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74 68  =0 />.Back to th
8730: 65 20 53 51 4c 69 74 65 20 48 6f 6d 65 20 50 61  e SQLite Home Pa
8740: 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 62  ge</a>.</p>..</b
8750: 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a           ody></html>}.