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

Artifact 75615f1acd8a428d93546ad9edfbf8f78ee1e2df:


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 33 31 20 32 30 30 32  .tcl,v 1.31 2002
0060: 2f 30 34 2f 30 36 20 31 34 3a 31 30 3a 34 38 20  /04/06 14:10:48 
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: 20 20 7b 7b 43 52 45 41 54 45 20 56 49 45 57 7d    {{CREATE VIEW}
0620: 20 63 72 65 61 74 65 76 69 65 77 7d 0a 20 20 7b   createview}.  {
0630: 7b 44 52 4f 50 20 56 49 45 57 7d 20 64 72 6f 70  {DROP VIEW} drop
0640: 76 69 65 77 7d 0a 7d 5d 20 7b 0a 20 20 70 75 74  view}.}] {.  put
0650: 73 20 22 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 5c  s "<li><a href=\
0660: 22 23 5b 6c 69 6e 64 65 78 20 24 73 65 63 74 69  "#[lindex $secti
0670: 6f 6e 20 31 5d 5c 22 3e 5b 6c 69 6e 64 65 78 20  on 1]\">[lindex 
0680: 24 73 65 63 74 69 6f 6e 20 30 5d 3c 2f 61 3e 3c  $section 0]</a><
0690: 2f 6c 69 3e 22 0a 7d 0a 70 75 74 73 20 7b 3c 2f  /li>".}.puts {</
06a0: 75 6c 3e 3c 2f 70 3e 0a 0a 3c 70 3e 44 65 74 61  ul></p>..<p>Deta
06b0: 69 6c 73 20 6f 6e 20 74 68 65 20 69 6d 70 6c 65  ils on the imple
06c0: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 65 61 63  mentation of eac
06d0: 68 20 63 6f 6d 6d 61 6e 64 20 61 72 65 20 70 72  h command are pr
06e0: 6f 76 69 64 65 64 20 69 6e 0a 74 68 65 20 73 65  ovided in.the se
06f0: 71 75 65 6c 2e 3c 2f 70 3e 0a 7d 0a 0a 70 72 6f  quel.</p>.}..pro
0700: 63 20 53 79 6e 74 61 78 20 7b 61 72 67 73 7d 20  c Syntax {args} 
0710: 7b 0a 20 20 70 75 74 73 20 7b 3c 74 61 62 6c 65  {.  puts {<table
0720: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 30   cellpadding="10
0730: 22 3e 7d 0a 20 20 66 6f 72 65 61 63 68 20 7b 72  ">}.  foreach {r
0740: 75 6c 65 20 62 6f 64 79 7d 20 24 61 72 67 73 20  ule body} $args 
0750: 7b 0a 20 20 20 20 70 75 74 73 20 22 3c 74 72 3e  {.    puts "<tr>
0760: 3c 74 64 20 61 6c 69 67 6e 3d 5c 22 72 69 67 68  <td align=\"righ
0770: 74 5c 22 20 76 61 6c 69 67 6e 3d 5c 22 74 6f 70  t\" valign=\"top
0780: 5c 22 3e 22 0a 20 20 20 20 70 75 74 73 20 22 3c  \">".    puts "<
0790: 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22  i><font color=\"
07a0: 23 66 66 33 34 33 34 5c 22 3e 24 72 75 6c 65 3c  #ff3434\">$rule<
07b0: 2f 66 6f 6e 74 3e 3c 2f 69 3e 26 6e 62 73 70 3b  /font></i>&nbsp;
07c0: 3a 3a 3d 3c 2f 74 64 3e 22 0a 20 20 20 20 72 65  ::=</td>".    re
07d0: 67 73 75 62 20 2d 61 6c 6c 20 3c 20 24 62 6f 64  gsub -all < $bod
07e0: 79 20 7b 25 4c 54 7d 20 62 6f 64 79 0a 20 20 20  y {%LT} body.   
07f0: 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 3e 20 24   regsub -all > $
0800: 62 6f 64 79 20 7b 25 47 54 7d 20 62 6f 64 79 0a  body {%GT} body.
0810: 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20      regsub -all 
0820: 25 4c 54 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e  %LT $body {</fon
0830: 74 3e 3c 2f 62 3e 3c 69 3e 3c 66 6f 6e 74 20 63  t></b><i><font c
0840: 6f 6c 6f 72 3d 22 23 66 66 33 34 33 34 22 3e 7d  olor="#ff3434">}
0850: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
0860: 20 2d 61 6c 6c 20 25 47 54 20 24 62 6f 64 79 20   -all %GT $body 
0870: 7b 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e 3c 62 3e 3c  {</font></i><b><
0880: 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32  font color="#2c2
0890: 63 66 30 22 3e 7d 20 62 6f 64 79 0a 20 20 20 20  cf0">} body.    
08a0: 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 5b 5d 7c  regsub -all {[]|
08b0: 5b 2a 3f 5d 7d 20 24 62 6f 64 79 20 7b 3c 2f 66  [*?]} $body {</f
08c0: 6f 6e 74 3e 3c 2f 62 3e 26 3c 62 3e 3c 66 6f 6e  ont></b>&<b><fon
08d0: 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30  t color="#2c2cf0
08e0: 22 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67  ">} body.    reg
08f0: 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 22 20 5b 73  sub -all "\n" [s
0900: 74 72 69 6e 67 20 74 72 69 6d 20 24 62 6f 64 79  tring trim $body
0910: 5d 20 22 3c 62 72 3e 5c 6e 22 20 62 6f 64 79 0a  ] "<br>\n" body.
0920: 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20      regsub -all 
0930: 22 5c 6e 20 20 2a 22 20 24 62 6f 64 79 20 22 5c  "\n  *" $body "\
0940: 6e 5c 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70  n\\&nbsp;\\&nbsp
0950: 3b 5c 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70  ;\\&nbsp;\\&nbsp
0960: 3b 22 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73  ;" body.    regs
0970: 75 62 20 2d 61 6c 6c 20 7b 5b 7c 2c 2e 2a 28 29  ub -all {[|,.*()
0980: 5d 7d 20 24 62 6f 64 79 20 7b 3c 62 69 67 3e 26  ]} $body {<big>&
0990: 3c 2f 62 69 67 3e 7d 20 62 6f 64 79 0a 20 20 20  </big>} body.   
09a0: 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 20 3d   regsub -all { =
09b0: 20 7d 20 24 62 6f 64 79 20 7b 20 3c 62 69 67 3e   } $body { <big>
09c0: 3d 3c 2f 62 69 67 3e 20 7d 20 62 6f 64 79 0a 20  =</big> } body. 
09d0: 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b     regsub -all {
09e0: 53 54 41 52 7d 20 24 62 6f 64 79 20 7b 3c 62 69  STAR} $body {<bi
09f0: 67 3e 2a 3c 2f 62 69 67 3e 7d 20 62 6f 64 79 0a  g>*</big>} body.
0a00: 20 20 20 20 70 75 74 73 20 22 3c 74 64 3e 3c 62      puts "<td><b
0a10: 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23  ><font color=\"#
0a20: 32 63 32 63 66 30 5c 22 3e 24 62 6f 64 79 3c 2f  2c2cf0\">$body</
0a30: 66 6f 6e 74 3e 3c 2f 62 3e 3c 2f 74 64 3e 3c 2f  font></b></td></
0a40: 74 72 3e 22 0a 20 20 7d 0a 20 20 70 75 74 73 20  tr>".  }.  puts 
0a50: 7b 3c 2f 74 61 62 6c 65 3e 7d 0a 7d 0a 70 72 6f  {</table>}.}.pro
0a60: 63 20 4f 70 65 72 61 74 6f 72 20 7b 6e 61 6d 65  c Operator {name
0a70: 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 22 3c 66  } {.  return "<f
0a80: 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32  ont color=\"#2c2
0a90: 63 66 30 5c 22 3e 3c 62 69 67 3e 24 6e 61 6d 65  cf0\"><big>$name
0aa0: 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74 3e 22 0a 7d  </big></font>".}
0ab0: 0a 70 72 6f 63 20 4e 6f 6e 74 65 72 6d 69 6e 61  .proc Nontermina
0ac0: 6c 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20 72 65 74  l {name} {.  ret
0ad0: 75 72 6e 20 22 3c 69 3e 3c 66 6f 6e 74 20 63 6f  urn "<i><font co
0ae0: 6c 6f 72 3d 5c 22 23 66 66 33 34 33 34 5c 22 3e  lor=\"#ff3434\">
0af0: 24 6e 61 6d 65 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e  $name</font></i>
0b00: 22 0a 7d 0a 70 72 6f 63 20 4b 65 79 77 6f 72 64  ".}.proc Keyword
0b10: 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20 72 65 74 75   {name} {.  retu
0b20: 72 6e 20 22 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d  rn "<font color=
0b30: 5c 22 23 32 63 32 63 66 30 5c 22 3e 24 6e 61 6d  \"#2c2cf0\">$nam
0b40: 65 3c 2f 66 6f 6e 74 3e 22 0a 7d 0a 20 0a 0a 70  e</font>".}. ..p
0b50: 72 6f 63 20 53 65 63 74 69 6f 6e 20 7b 6e 61 6d  roc Section {nam
0b60: 65 20 7b 6c 61 62 65 6c 20 7b 7d 7d 7d 20 7b 0a  e {label {}}} {.
0b70: 20 20 70 75 74 73 20 22 5c 6e 3c 68 72 20 2f 3e    puts "\n<hr />
0b80: 22 0a 20 20 69 66 20 7b 24 6c 61 62 65 6c 21 3d  ".  if {$label!=
0b90: 22 22 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 22  ""} {.    puts "
0ba0: 3c 61 20 6e 61 6d 65 3d 5c 22 24 6c 61 62 65 6c  <a name=\"$label
0bb0: 5c 22 3e 22 0a 20 20 7d 0a 20 20 70 75 74 73 20  \">".  }.  puts 
0bc0: 22 3c 68 31 3e 24 6e 61 6d 65 3c 2f 68 31 3e 5c  "<h1>$name</h1>\
0bd0: 6e 22 0a 7d 0a 0a 70 72 6f 63 20 45 78 61 6d 70  n".}..proc Examp
0be0: 6c 65 20 7b 74 65 78 74 7d 20 7b 0a 20 20 70 75  le {text} {.  pu
0bf0: 74 73 20 22 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  ts "<blockquote>
0c00: 3c 70 72 65 3e 24 74 65 78 74 3c 2f 70 72 65 3e  <pre>$text</pre>
0c10: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 22 0a 7d  </blockquote>".}
0c20: 0a 0a 53 65 63 74 69 6f 6e 20 7b 42 45 47 49 4e  ..Section {BEGIN
0c30: 20 54 52 41 4e 53 41 43 54 49 4f 4e 7d 20 63 72   TRANSACTION} cr
0c40: 65 61 74 65 69 6e 64 65 78 0a 0a 53 79 6e 74 61  eateindex..Synta
0c50: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
0c60: 7d 20 7b 0a 42 45 47 49 4e 20 5b 54 52 41 4e 53  } {.BEGIN [TRANS
0c70: 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d  ACTION [<name>]]
0c80: 20 5b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 63   [ON CONFLICT <c
0c90: 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68  onflict-algorith
0ca0: 6d 3e 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b 73 71  m>].}.Syntax {sq
0cb0: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 45  l-statement} {.E
0cc0: 4e 44 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e 20  ND [TRANSACTION 
0cd0: 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 53 79 6e 74  [<name>]].}.Synt
0ce0: 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e  ax {sql-statemen
0cf0: 74 7d 20 7b 0a 43 4f 4d 4d 49 54 20 5b 54 52 41  t} {.COMMIT [TRA
0d00: 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e  NSACTION [<name>
0d10: 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b 73 71 6c  ]].}.Syntax {sql
0d20: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 52 4f  -statement} {.RO
0d30: 4c 4c 42 41 43 4b 20 5b 54 52 41 4e 53 41 43 54  LLBACK [TRANSACT
0d40: 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a  ION [<name>]].}.
0d50: 0a 70 75 74 73 20 7b 0a 3c 70 3e 42 65 67 69 6e  .puts {.<p>Begin
0d60: 6e 69 6e 67 20 69 6e 20 76 65 72 73 69 6f 6e 20  ning in version 
0d70: 32 2e 30 2c 20 53 51 4c 69 74 65 20 73 75 70 70  2.0, SQLite supp
0d80: 6f 72 74 73 20 74 72 61 6e 73 61 63 74 69 6f 6e  orts transaction
0d90: 73 20 77 69 74 68 0a 72 6f 6c 6c 62 61 63 6b 20  s with.rollback 
0da0: 61 6e 64 20 61 74 6f 6d 69 63 20 63 6f 6d 6d 69  and atomic commi
0db0: 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4e 6f 20 63  t.</p>..<p>.No c
0dc0: 68 61 6e 67 65 73 20 63 61 6e 20 62 65 20 6d 61  hanges can be ma
0dd0: 64 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  de to the databa
0de0: 73 65 20 65 78 63 65 70 74 20 77 69 74 68 69 6e  se except within
0df0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a   a transaction..
0e00: 41 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74  Any command that
0e10: 20 63 68 61 6e 67 65 73 20 74 68 65 20 64 61 74   changes the dat
0e20: 61 62 61 73 65 20 28 62 61 73 69 63 61 6c 6c 79  abase (basically
0e30: 2c 20 61 6e 79 20 53 51 4c 20 63 6f 6d 6d 61 6e  , any SQL comman
0e40: 64 0a 6f 74 68 65 72 20 74 68 61 6e 20 53 45 4c  d.other than SEL
0e50: 45 43 54 29 20 77 69 6c 6c 20 61 75 74 6f 6d 61  ECT) will automa
0e60: 74 69 63 61 6c 6c 79 20 73 74 61 72 74 73 20 61  tically starts a
0e70: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 66 0a   transaction if.
0e80: 6f 6e 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61  one is not alrea
0e90: 64 79 20 69 6e 20 65 66 66 65 63 74 2e 20 20 41  dy in effect.  A
0ea0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 74 61  utomatically sta
0eb0: 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 73  red transactions
0ec0: 0a 61 72 65 20 63 6f 6d 6d 69 74 74 65 64 20 61  .are committed a
0ed0: 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e  t the conclusion
0ee0: 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e   of the command.
0ef0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 72 61 6e 73  .</p>..<p>.Trans
0f00: 61 63 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 73  actions can be s
0f10: 74 61 72 74 65 64 20 6d 61 6e 75 61 6c 6c 79 20  tarted manually 
0f20: 75 73 69 6e 67 20 74 68 65 20 42 45 47 49 4e 0a  using the BEGIN.
0f30: 63 6f 6d 6d 61 6e 64 2e 20 53 75 63 68 20 74 72  command. Such tr
0f40: 61 6e 73 61 63 74 69 6f 6e 73 20 75 73 75 61 6c  ansactions usual
0f50: 6c 79 20 70 65 72 73 69 73 74 20 75 6e 74 69 6c  ly persist until
0f60: 20 74 68 65 20 6e 65 78 74 0a 43 4f 4d 4d 49 54   the next.COMMIT
0f70: 20 6f 72 20 52 4f 4c 4c 42 41 43 4b 20 63 6f 6d   or ROLLBACK com
0f80: 6d 61 6e 64 2e 20 42 75 74 20 61 20 74 72 61 6e  mand. But a tran
0f90: 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20 61 6c 73  saction will als
0fa0: 6f 20 0a 52 4f 4c 4c 42 41 43 4b 20 69 66 20 74  o .ROLLBACK if t
0fb0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63  he database is c
0fc0: 6c 6f 73 65 64 20 6f 72 20 69 66 20 61 6e 20 65  losed or if an e
0fd0: 72 72 6f 72 20 6f 63 63 75 72 73 0a 61 6e 64 20  rror occurs.and 
0fe0: 74 68 65 20 52 4f 4c 4c 42 41 43 4b 20 63 6f 6e  the ROLLBACK con
0ff0: 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e  flict resolution
1000: 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 73 70   algorithm is sp
1010: 65 63 69 66 69 65 64 2e 0a 53 65 65 20 74 68 65  ecified..See the
1020: 20 64 6f 63 75 6d 65 6e 74 69 6f 6e 20 6f 6e 20   documention on 
1030: 74 68 65 20 3c 61 20 68 72 65 66 3d 22 23 63 6f  the <a href="#co
1040: 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c  nflict">ON CONFL
1050: 49 43 54 3c 2f 61 3e 0a 63 6c 61 75 73 65 20 66  ICT</a>.clause f
1060: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  or additional in
1070: 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20  formation about 
1080: 74 68 65 20 52 4f 4c 4c 42 41 43 4b 0a 63 6f 6e  the ROLLBACK.con
1090: 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e  flict resolution
10a0: 20 61 6c 67 6f 72 69 74 68 6d 2e 0a 3c 2f 70 3e   algorithm..</p>
10b0: 0a 0a 3c 70 3e 0a 54 68 65 20 6f 70 74 69 6f 6e  ..<p>.The option
10c0: 61 6c 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63  al ON CONFLICT c
10d0: 6c 61 75 73 65 20 61 74 20 74 68 65 20 65 6e 64  lause at the end
10e0: 20 6f 66 20 61 20 42 45 47 49 4e 20 73 74 61 74   of a BEGIN stat
10f0: 65 6d 65 6e 74 0a 63 61 6e 20 62 65 20 75 73 65  ement.can be use
1100: 64 20 74 6f 20 63 68 61 6e 67 65 64 20 74 68 65  d to changed the
1110: 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 6c 69 63   default conflic
1120: 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67  t resolution alg
1130: 6f 72 69 74 68 6d 2e 0a 54 68 65 20 6e 6f 72 6d  orithm..The norm
1140: 61 6c 20 64 65 66 61 75 6c 74 20 69 73 20 41 42  al default is AB
1150: 4f 52 54 2e 20 20 49 66 20 61 6e 20 61 6c 74 65  ORT.  If an alte
1160: 72 6e 61 74 69 76 65 20 69 73 20 73 70 65 63 69  rnative is speci
1170: 66 69 65 64 20 62 79 0a 74 68 65 20 4f 4e 20 43  fied by.the ON C
1180: 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 20 6f  ONFLICT clause o
1190: 66 20 61 20 42 45 47 49 4e 2c 20 74 68 65 6e 20  f a BEGIN, then 
11a0: 74 68 61 74 20 61 6c 74 65 72 6e 61 74 69 76 65  that alternative
11b0: 20 69 73 20 75 73 65 64 0a 61 73 20 74 68 65 20   is used.as the 
11c0: 64 65 66 61 75 6c 74 20 66 6f 72 20 61 6c 6c 20  default for all 
11d0: 63 6f 6d 6d 61 6e 64 73 20 77 69 74 68 69 6e 20  commands within 
11e0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e  the transaction.
11f0: 20 20 54 68 65 20 64 65 66 61 75 6c 74 0a 61 6c    The default.al
1200: 67 6f 72 69 74 68 6d 20 69 73 20 6f 76 65 72 72  gorithm is overr
1210: 69 64 64 65 6e 20 62 79 20 4f 4e 20 43 4f 4e 46  idden by ON CONF
1220: 4c 49 43 54 20 63 6c 61 75 73 65 73 20 6f 6e 20  LICT clauses on 
1230: 69 6e 64 69 76 69 64 75 61 6c 0a 63 6f 6e 73 74  individual.const
1240: 72 61 69 6e 74 73 20 77 69 74 68 69 6e 20 74 68  raints within th
1250: 65 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 6f  e CREATE TABLE o
1260: 72 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 73  r CREATE INDEX s
1270: 74 61 74 65 6d 65 6e 74 73 0a 61 6e 64 20 62 79  tatements.and by
1280: 20 74 68 65 20 4f 52 20 63 6c 61 75 73 65 73 20   the OR clauses 
1290: 6f 6e 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c  on COPY, INSERT,
12a0: 20 61 6e 64 20 55 50 44 41 54 45 20 63 6f 6d 6d   and UPDATE comm
12b0: 61 6e 64 73 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65  ands..</p>.}..Se
12c0: 63 74 69 6f 6e 20 43 4f 50 59 20 63 6f 70 79 0a  ction COPY copy.
12d0: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61  .Syntax {sql-sta
12e0: 74 65 6d 65 6e 74 7d 20 7b 0a 43 4f 50 59 20 5b  tement} {.COPY [
12f0: 20 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c   OR <conflict-al
1300: 67 6f 72 69 74 68 6d 3e 20 5d 20 3c 74 61 62 6c  gorithm> ] <tabl
1310: 65 2d 6e 61 6d 65 3e 20 46 52 4f 4d 20 3c 66 69  e-name> FROM <fi
1320: 6c 65 6e 61 6d 65 3e 0a 5b 20 55 53 49 4e 47 20  lename>.[ USING 
1330: 44 45 4c 49 4d 49 54 45 52 53 20 3c 64 65 6c 69  DELIMITERS <deli
1340: 6d 3e 20 5d 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a  m> ].}...puts {.
1350: 3c 70 3e 54 68 65 20 43 4f 50 59 20 63 6f 6d 6d  <p>The COPY comm
1360: 61 6e 64 20 69 73 20 61 6e 20 65 78 74 65 6e 73  and is an extens
1370: 69 6f 6e 20 75 73 65 64 20 74 6f 20 6c 6f 61 64  ion used to load
1380: 20 6c 61 72 67 65 20 61 6d 6f 75 6e 74 73 20 6f   large amounts o
1390: 66 0a 64 61 74 61 20 69 6e 74 6f 20 61 20 74 61  f.data into a ta
13a0: 62 6c 65 2e 20 20 49 74 20 69 73 20 6d 6f 64 65  ble.  It is mode
13b0: 6c 65 64 20 61 66 74 65 72 20 61 20 73 69 6d 69  led after a simi
13c0: 6c 61 72 20 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e  lar command foun
13d0: 64 0a 69 6e 20 50 6f 73 74 67 72 65 53 51 4c 2e  d.in PostgreSQL.
13e0: 20 20 49 6e 20 66 61 63 74 2c 20 74 68 65 20 53    In fact, the S
13f0: 51 4c 69 74 65 20 43 4f 50 59 20 63 6f 6d 6d 61  QLite COPY comma
1400: 6e 64 20 69 73 20 73 70 65 63 69 66 69 63 61 6c  nd is specifical
1410: 6c 79 0a 64 65 73 69 67 6e 65 64 20 74 6f 20 62  ly.designed to b
1420: 65 20 61 62 6c 65 20 74 6f 20 72 65 61 64 20 74  e able to read t
1430: 68 65 20 6f 75 74 70 75 74 20 6f 66 20 74 68 65  he output of the
1440: 20 50 6f 73 74 67 72 65 53 51 4c 20 64 75 6d 70   PostgreSQL dump
1450: 0a 75 74 69 6c 69 74 79 20 3c 62 3e 70 67 5f 64  .utility <b>pg_d
1460: 75 6d 70 3c 2f 62 3e 20 73 6f 20 74 68 61 74 20  ump</b> so that 
1470: 64 61 74 61 20 63 61 6e 20 62 65 20 65 61 73 69  data can be easi
1480: 6c 79 20 74 72 61 6e 73 66 65 72 72 65 64 20 66  ly transferred f
1490: 72 6f 6d 0a 50 6f 73 74 67 72 65 53 51 4c 20 69  rom.PostgreSQL i
14a0: 6e 74 6f 20 53 51 4c 69 74 65 2e 3c 70 3e 0a 0a  nto SQLite.<p>..
14b0: 3c 70 3e 54 68 65 20 74 61 62 6c 65 2d 6e 61 6d  <p>The table-nam
14c0: 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66  e is the name of
14d0: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 74 61 62   an existing tab
14e0: 6c 65 20 77 68 69 63 68 20 69 73 20 74 6f 0a 62  le which is to.b
14f0: 65 20 66 69 6c 6c 65 64 20 77 69 74 68 20 64 61  e filled with da
1500: 74 61 2e 20 20 54 68 65 20 66 69 6c 65 6e 61 6d  ta.  The filenam
1510: 65 20 69 73 20 61 20 73 74 72 69 6e 67 20 6f 72  e is a string or
1520: 20 69 64 65 6e 74 69 66 69 65 72 20 74 68 61 74   identifier that
1530: 0a 6e 61 6d 65 73 20 61 20 66 69 6c 65 20 66 72  .names a file fr
1540: 6f 6d 20 77 68 69 63 68 20 64 61 74 61 20 77 69  om which data wi
1550: 6c 6c 20 62 65 20 72 65 61 64 2e 20 20 54 68 65  ll be read.  The
1560: 20 66 69 6c 65 6e 61 6d 65 20 63 61 6e 20 62 65   filename can be
1570: 0a 74 68 65 20 3c 62 3e 53 54 44 49 4e 3c 2f 62  .the <b>STDIN</b
1580: 3e 20 74 6f 20 72 65 61 64 20 64 61 74 61 20 66  > to read data f
1590: 72 6f 6d 20 73 74 61 6e 64 61 72 64 20 69 6e 70  rom standard inp
15a0: 75 74 2e 3c 70 3e 0a 0a 3c 70 3e 45 61 63 68 20  ut.<p>..<p>Each 
15b0: 6c 69 6e 65 20 6f 66 20 74 68 65 20 69 6e 70 75  line of the inpu
15c0: 74 20 66 69 6c 65 20 69 73 20 63 6f 6e 76 65 72  t file is conver
15d0: 74 65 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c  ted into a singl
15e0: 65 20 72 65 63 6f 72 64 0a 69 6e 20 74 68 65 20  e record.in the 
15f0: 74 61 62 6c 65 2e 20 20 43 6f 6c 75 6d 6e 73 20  table.  Columns 
1600: 61 72 65 20 73 65 70 61 72 61 74 65 64 20 62 79  are separated by
1610: 20 74 61 62 73 2e 20 20 49 66 20 61 20 74 61 62   tabs.  If a tab
1620: 20 6f 63 63 75 72 73 20 61 73 0a 64 61 74 61 20   occurs as.data 
1630: 77 69 74 68 69 6e 20 61 20 63 6f 6c 75 6d 6e 2c  within a column,
1640: 20 74 68 65 6e 20 74 68 61 74 20 74 61 62 20 69   then that tab i
1650: 73 20 70 72 65 63 65 64 65 64 20 62 79 20 61 20  s preceded by a 
1660: 62 61 73 6b 73 6c 61 73 68 20 22 5c 22 0a 63 68  baskslash "\".ch
1670: 61 72 61 63 74 65 72 2e 20 20 41 20 62 61 73 6b  aracter.  A bask
1680: 73 6c 61 73 68 20 69 6e 20 74 68 65 20 64 61 74  slash in the dat
1690: 61 20 61 70 70 65 61 72 73 20 61 73 20 74 77 6f  a appears as two
16a0: 20 62 61 63 6b 73 6c 61 73 68 65 73 20 69 6e 0a   backslashes in.
16b0: 61 20 72 6f 77 2e 20 20 54 68 65 20 6f 70 74 69  a row.  The opti
16c0: 6f 6e 61 6c 20 55 53 49 4e 47 20 44 45 4c 49 4d  onal USING DELIM
16d0: 49 54 45 52 53 20 63 6c 61 75 73 65 20 63 61 6e  ITERS clause can
16e0: 20 73 70 65 63 69 66 79 20 61 20 64 65 6c 69 6d   specify a delim
16f0: 69 74 65 72 0a 6f 74 68 65 72 20 74 68 61 6e 20  iter.other than 
1700: 74 61 62 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20  tab.</p>..<p>If 
1710: 61 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73 69 73 74  a column consist
1720: 73 20 6f 66 20 74 68 65 20 63 68 61 72 61 63 74  s of the charact
1730: 65 72 20 22 5c 4e 22 2c 20 74 68 61 74 20 63 6f  er "\N", that co
1740: 6c 75 6d 6e 20 69 73 20 66 69 6c 6c 65 64 0a 77  lumn is filled.w
1750: 69 74 68 20 74 68 65 20 76 61 6c 75 65 20 4e 55  ith the value NU
1760: 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  LL.</p>..<p>The 
1770: 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63  optional conflic
1780: 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20  t-clause allows 
1790: 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69 6f  the specificatio
17a0: 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74  n of an alternat
17b0: 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63  ive.constraint c
17c0: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
17d0: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20  on algorithm to 
17e0: 75 73 65 20 66 6f 72 20 74 68 69 73 20 6f 6e 65  use for this one
17f0: 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20 74 68   command..See th
1800: 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c 65 64  e section titled
1810: 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c  .<a href="#confl
1820: 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54  ict">ON CONFLICT
1830: 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74 69 6f  </a> for additio
1840: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e  nal information.
1850: 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 74 68  </p>..<p>When th
1860: 65 20 69 6e 70 75 74 20 64 61 74 61 20 73 6f 75  e input data sou
1870: 72 63 65 20 69 73 20 53 54 44 49 4e 2c 20 74 68  rce is STDIN, th
1880: 65 20 69 6e 70 75 74 20 63 61 6e 20 62 65 20 74  e input can be t
1890: 65 72 6d 69 6e 61 74 65 64 0a 62 79 20 61 20 6c  erminated.by a l
18a0: 69 6e 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e  ine that contain
18b0: 73 20 6f 6e 6c 79 20 61 20 62 61 73 6b 73 6c 61  s only a basksla
18c0: 73 68 20 61 6e 64 20 61 20 64 6f 74 3a 7d 0a 70  sh and a dot:}.p
18d0: 75 74 73 20 22 5c 22 5b 4f 70 65 72 61 74 6f 72  uts "\"[Operator
18e0: 20 5c 5c 2e 5d 5c 22 2e 3c 2f 70 3e 22 0a 0a 53   \\.]\".</p>"..S
18f0: 65 63 74 69 6f 6e 20 7b 43 52 45 41 54 45 20 49  ection {CREATE I
1900: 4e 44 45 58 7d 20 63 72 65 61 74 65 69 6e 64 65  NDEX} createinde
1910: 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  x..Syntax {sql-s
1920: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41  tatement} {.CREA
1930: 54 45 20 5b 55 4e 49 51 55 45 5d 20 49 4e 44 45  TE [UNIQUE] INDE
1940: 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 20 0a  X <index-name> .
1950: 4f 4e 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  ON <table-name> 
1960: 28 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20  ( <column-name> 
1970: 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e  [, <column-name>
1980: 5d 2a 20 29 0a 5b 20 4f 4e 20 43 4f 4e 46 4c 49  ]* ).[ ON CONFLI
1990: 43 54 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67  CT <conflict-alg
19a0: 6f 72 69 74 68 6d 3e 20 5d 0a 7d 20 7b 63 6f 6c  orithm> ].} {col
19b0: 75 6d 6e 2d 6e 61 6d 65 7d 20 7b 0a 3c 6e 61 6d  umn-name} {.<nam
19c0: 65 3e 20 5b 20 41 53 43 20 7c 20 44 45 53 43 20  e> [ ASC | DESC 
19d0: 5d 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  ].}...puts {.<p>
19e0: 54 68 65 20 43 52 45 41 54 45 20 49 4e 44 45 58  The CREATE INDEX
19f0: 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74   command consist
1a00: 73 20 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64  s of the keyword
1a10: 73 20 22 43 52 45 41 54 45 20 49 4e 44 45 58 22  s "CREATE INDEX"
1a20: 20 66 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65   followed.by the
1a30: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6e 65 77   name of the new
1a40: 20 69 6e 64 65 78 2c 20 74 68 65 20 6b 65 79 77   index, the keyw
1a50: 6f 72 64 20 22 4f 4e 22 2c 20 74 68 65 20 6e 61  ord "ON", the na
1a60: 6d 65 20 6f 66 20 61 20 70 72 65 76 69 6f 75 73  me of a previous
1a70: 6c 79 0a 63 72 65 61 74 65 64 20 74 61 62 6c 65  ly.created table
1a80: 20 74 68 61 74 20 69 73 20 74 6f 20 62 65 20 69   that is to be i
1a90: 6e 64 65 78 65 64 2c 20 61 6e 64 20 61 20 70 61  ndexed, and a pa
1aa0: 72 65 6e 74 68 65 73 69 7a 65 64 20 6c 69 73 74  renthesized list
1ab0: 20 6f 66 20 6e 61 6d 65 73 20 6f 66 0a 63 6f 6c   of names of.col
1ac0: 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c  umns in the tabl
1ad0: 65 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20  e that are used 
1ae0: 66 6f 72 20 74 68 65 20 69 6e 64 65 78 20 6b 65  for the index ke
1af0: 79 2e 0a 45 61 63 68 20 63 6f 6c 75 6d 6e 20 6e  y..Each column n
1b00: 61 6d 65 20 63 61 6e 20 62 65 20 66 6f 6c 6c 6f  ame can be follo
1b10: 77 65 64 20 62 79 20 6f 6e 65 20 6f 66 20 74 68  wed by one of th
1b20: 65 20 22 41 53 43 22 20 6f 72 20 22 44 45 53 43  e "ASC" or "DESC
1b30: 22 20 6b 65 79 77 6f 72 64 73 0a 74 6f 20 69 6e  " keywords.to in
1b40: 64 69 63 61 74 65 20 73 6f 72 74 20 6f 72 64 65  dicate sort orde
1b50: 72 2c 20 62 75 74 20 74 68 65 20 73 6f 72 74 20  r, but the sort 
1b60: 6f 72 64 65 72 20 69 73 20 69 67 6e 6f 72 65 64  order is ignored
1b70: 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 0a   in the current.
1b80: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 3c  implementation.<
1b90: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72  /p>..<p>There ar
1ba0: 65 20 6e 6f 20 61 72 62 69 74 72 61 72 79 20 6c  e no arbitrary l
1bb0: 69 6d 69 74 73 20 6f 6e 20 74 68 65 20 6e 75 6d  imits on the num
1bc0: 62 65 72 20 6f 66 20 69 6e 64 69 63 65 73 20 74  ber of indices t
1bd0: 68 61 74 20 63 61 6e 20 62 65 0a 61 74 74 61 63  hat can be.attac
1be0: 68 65 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20  hed to a single 
1bf0: 74 61 62 6c 65 2c 20 6e 6f 72 20 6f 6e 20 74 68  table, nor on th
1c00: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  e number of colu
1c10: 6d 6e 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 2e  mns in an index.
1c20: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20  </p>..<p>If the 
1c30: 55 4e 49 51 55 45 20 6b 65 79 77 6f 72 64 20 61  UNIQUE keyword a
1c40: 70 70 65 61 72 73 20 62 65 74 77 65 65 6e 20 43  ppears between C
1c50: 52 45 41 54 45 20 61 6e 64 20 49 4e 44 45 58 20  REATE and INDEX 
1c60: 74 68 65 6e 20 64 75 70 6c 69 63 61 74 65 0a 69  then duplicate.i
1c70: 6e 64 65 78 20 65 6e 74 72 69 65 73 20 61 72 65  ndex entries are
1c80: 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 2e 20 20 41   not allowed.  A
1c90: 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 69 6e  ny attempt to in
1ca0: 73 65 72 74 20 61 20 64 75 70 6c 69 63 61 74 65  sert a duplicate
1cb0: 20 65 6e 74 72 79 0a 77 69 6c 6c 20 72 65 73 75   entry.will resu
1cc0: 6c 74 20 69 6e 20 61 20 72 6f 6c 6c 62 61 63 6b  lt in a rollback
1cd0: 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 20 6d 65   and an error me
1ce0: 73 73 61 67 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  ssage.</p>..<p>T
1cf0: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66  he optional conf
1d00: 6c 69 63 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f  lict-clause allo
1d10: 77 73 20 74 68 65 20 73 70 65 63 69 66 69 63 61  ws the specifica
1d20: 74 69 6f 6e 20 6f 66 20 61 6c 20 61 6c 74 65 72  tion of al alter
1d30: 6e 61 74 69 76 65 0a 64 65 66 61 75 6c 74 20 63  native.default c
1d40: 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c 69  onstraint confli
1d50: 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c  ct resolution al
1d60: 67 6f 72 69 74 68 6d 20 66 6f 72 20 74 68 69 73  gorithm for this
1d70: 20 69 6e 64 65 78 2e 0a 54 68 69 73 20 6f 6e 6c   index..This onl
1d80: 79 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 69 66  y makes sense if
1d90: 20 74 68 65 20 55 4e 49 51 55 45 20 6b 65 79 77   the UNIQUE keyw
1da0: 6f 72 64 20 69 73 20 75 73 65 64 20 73 69 6e 63  ord is used sinc
1db0: 65 20 6f 74 68 65 72 77 69 73 65 0a 74 68 65 72  e otherwise.ther
1dc0: 65 20 61 72 65 20 6e 6f 74 20 63 6f 6e 73 74 72  e are not constr
1dd0: 61 69 6e 74 73 20 6f 6e 20 74 68 65 20 69 6e 64  aints on the ind
1de0: 65 78 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74  ex.  The default
1df0: 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 0a 41 42   algorithm is.AB
1e00: 4f 52 54 2e 20 20 49 66 20 61 20 43 4f 50 59 2c  ORT.  If a COPY,
1e10: 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41   INSERT, or UPDA
1e20: 54 45 20 73 74 61 74 65 6d 65 6e 74 20 73 70 65  TE statement spe
1e30: 63 69 66 69 65 73 20 61 20 70 61 72 74 69 63 75  cifies a particu
1e40: 6c 61 72 0a 63 6f 6e 66 6c 69 63 74 20 72 65 73  lar.conflict res
1e50: 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  olution algorith
1e60: 6d 2c 20 74 68 61 74 20 61 6c 67 6f 72 69 74 68  m, that algorith
1e70: 6d 20 69 73 20 75 73 65 64 20 69 6e 20 70 6c 61  m is used in pla
1e80: 63 65 20 6f 66 0a 74 68 65 20 64 65 66 61 75 6c  ce of.the defaul
1e90: 74 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63  t algorithm spec
1ea0: 69 66 69 65 64 20 68 65 72 65 2e 0a 53 65 65 20  ified here..See 
1eb0: 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c  the section titl
1ec0: 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e  ed.<a href="#con
1ed0: 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49  flict">ON CONFLI
1ee0: 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74  CT</a> for addit
1ef0: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
1f00: 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 65  n.</p>..<p>The e
1f10: 78 61 63 74 20 74 65 78 74 0a 6f 66 20 65 61 63  xact text.of eac
1f20: 68 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 73  h CREATE INDEX s
1f30: 74 61 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72  tatement is stor
1f40: 65 64 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c  ed in the <b>sql
1f50: 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a 74  ite_master</b>.t
1f60: 61 62 6c 65 2e 20 20 45 76 65 72 79 74 69 6d 65  able.  Everytime
1f70: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
1f80: 20 6f 70 65 6e 65 64 2c 20 61 6c 6c 20 43 52 45   opened, all CRE
1f90: 41 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d  ATE INDEX statem
1fa0: 65 6e 74 73 0a 61 72 65 20 72 65 61 64 20 66 72  ents.are read fr
1fb0: 6f 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65  om the <b>sqlite
1fc0: 5f 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c  _master</b> tabl
1fd0: 65 20 61 6e 64 20 75 73 65 64 20 74 6f 20 72 65  e and used to re
1fe0: 67 65 6e 65 72 61 74 65 0a 53 51 4c 69 74 65 27  generate.SQLite'
1ff0: 73 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65  s internal repre
2000: 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  sentation of the
2010: 20 69 6e 64 65 78 20 6c 61 79 6f 75 74 2e 3c 2f   index layout.</
2020: 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b  p>.}...Section {
2030: 43 52 45 41 54 45 20 54 41 42 4c 45 7d 20 7b 63  CREATE TABLE} {c
2040: 72 65 61 74 65 74 61 62 6c 65 7d 0a 0a 53 79 6e  reatetable}..Syn
2050: 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64  tax {sql-command
2060: 7d 20 7b 0a 43 52 45 41 54 45 20 5b 54 45 4d 50  } {.CREATE [TEMP
2070: 20 7c 20 54 45 4d 50 4f 52 41 52 59 5d 20 54 41   | TEMPORARY] TA
2080: 42 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  BLE <table-name>
2090: 20 28 0a 20 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66   (.  <column-def
20a0: 3e 20 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66  > [, <column-def
20b0: 3e 5d 2a 0a 20 20 5b 2c 20 3c 63 6f 6e 73 74 72  >]*.  [, <constr
20c0: 61 69 6e 74 3e 5d 2a 0a 29 0a 7d 20 7b 73 71 6c  aint>]*.).} {sql
20d0: 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 43 52 45 41  -command} {.CREA
20e0: 54 45 20 5b 54 45 4d 50 20 7c 20 54 45 4d 50 4f  TE [TEMP | TEMPO
20f0: 52 41 52 59 5d 20 54 41 42 4c 45 20 3c 74 61 62  RARY] TABLE <tab
2100: 6c 65 2d 6e 61 6d 65 3e 20 41 53 20 3c 73 65 6c  le-name> AS <sel
2110: 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d  ect-statement>.}
2120: 20 7b 63 6f 6c 75 6d 6e 2d 64 65 66 7d 20 7b 0a   {column-def} {.
2130: 3c 6e 61 6d 65 3e 20 5b 3c 74 79 70 65 3e 5d 20  <name> [<type>] 
2140: 5b 3c 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61  [<column-constra
2150: 69 6e 74 3e 5d 2a 0a 7d 20 7b 74 79 70 65 7d 20  int>]*.} {type} 
2160: 7b 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 7c 0a 3c  {.<typename> |.<
2170: 74 79 70 65 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d  typename> ( <num
2180: 62 65 72 3e 20 29 20 7c 0a 3c 74 79 70 65 6e 61  ber> ) |.<typena
2190: 6d 65 3e 20 28 20 3c 6e 75 6d 62 65 72 3e 20 2c  me> ( <number> ,
21a0: 20 3c 6e 75 6d 62 65 72 3e 20 29 0a 7d 20 7b 63   <number> ).} {c
21b0: 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61 69 6e 74  olumn-constraint
21c0: 7d 20 7b 0a 4e 4f 54 20 4e 55 4c 4c 20 5b 20 3c  } {.NOT NULL [ <
21d0: 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e  conflict-clause>
21e0: 20 5d 20 7c 0a 50 52 49 4d 41 52 59 20 4b 45 59   ] |.PRIMARY KEY
21f0: 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20   [<sort-order>] 
2200: 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  [ <conflict-clau
2210: 73 65 3e 20 5d 20 7c 0a 55 4e 49 51 55 45 20 5b  se> ] |.UNIQUE [
2220: 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73   <conflict-claus
2230: 65 3e 20 5d 20 7c 0a 43 48 45 43 4b 20 28 20 3c  e> ] |.CHECK ( <
2240: 65 78 70 72 3e 20 29 20 5b 20 3c 63 6f 6e 66 6c  expr> ) [ <confl
2250: 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d 20 7c 0a  ict-clause> ] |.
2260: 44 45 46 41 55 4c 54 20 3c 76 61 6c 75 65 3e 0a  DEFAULT <value>.
2270: 7d 20 7b 63 6f 6e 73 74 72 61 69 6e 74 7d 20 7b  } {constraint} {
2280: 0a 50 52 49 4d 41 52 59 20 4b 45 59 20 28 20 3c  .PRIMARY KEY ( <
2290: 6e 61 6d 65 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d  name> [, <name>]
22a0: 2a 20 29 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d  * ) [ <conflict-
22b0: 63 6c 61 75 73 65 3e 20 5d 7c 0a 55 4e 49 51 55  clause> ]|.UNIQU
22c0: 45 20 28 20 3c 6e 61 6d 65 3e 20 5b 2c 20 3c 6e  E ( <name> [, <n
22d0: 61 6d 65 3e 5d 2a 20 29 20 5b 20 3c 63 6f 6e 66  ame>]* ) [ <conf
22e0: 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d 20 7c  lict-clause> ] |
22f0: 0a 43 48 45 43 4b 20 28 20 3c 65 78 70 72 3e 20  .CHECK ( <expr> 
2300: 29 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  ) [ <conflict-cl
2310: 61 75 73 65 3e 20 5d 0a 7d 20 7b 63 6f 6e 66 6c  ause> ].} {confl
2320: 69 63 74 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f 4e  ict-clause} {.ON
2330: 20 43 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c   CONFLICT <confl
2340: 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 0a 7d  ict-algorithm>.}
2350: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 41 20 43 52  ..puts {.<p>A CR
2360: 45 41 54 45 20 54 41 42 4c 45 20 73 74 61 74 65  EATE TABLE state
2370: 6d 65 6e 74 20 69 73 20 62 61 73 69 63 61 6c 6c  ment is basicall
2380: 79 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22  y the keywords "
2390: 43 52 45 41 54 45 20 54 41 42 4c 45 22 0a 66 6f  CREATE TABLE".fo
23a0: 6c 6c 6f 77 65 64 20 62 79 20 74 68 65 20 6e 61  llowed by the na
23b0: 6d 65 20 6f 66 20 61 20 6e 65 77 20 74 61 62 6c  me of a new tabl
23c0: 65 20 61 6e 64 20 61 20 70 61 72 65 6e 74 68 65  e and a parenthe
23d0: 73 69 7a 65 64 20 6c 69 73 74 20 6f 66 20 63 6f  sized list of co
23e0: 6c 75 6d 6e 0a 64 65 66 69 6e 69 74 69 6f 6e 73  lumn.definitions
23f0: 20 61 6e 64 20 63 6f 6e 73 74 72 61 69 6e 74 73   and constraints
2400: 2e 20 20 54 68 65 20 74 61 62 6c 65 20 6e 61 6d  .  The table nam
2410: 65 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20  e can be either 
2420: 61 6e 20 69 64 65 6e 74 69 66 69 65 72 0a 6f 72  an identifier.or
2430: 20 61 20 73 74 72 69 6e 67 2e 20 20 54 68 65 20   a string.  The 
2440: 6f 6e 6c 79 20 72 65 73 65 72 76 65 64 20 74 61  only reserved ta
2450: 62 6c 65 20 6e 61 6d 65 20 69 73 20 22 3c 62 3e  ble name is "<b>
2460: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62  sqlite_master</b
2470: 3e 22 20 77 68 69 63 68 0a 69 73 20 74 68 65 20  >" which.is the 
2480: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
2490: 65 20 74 68 61 74 20 72 65 63 6f 72 64 73 20 74  e that records t
24a0: 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65  he database sche
24b0: 6d 61 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45 61 63 68  ma.</p>..<p>Each
24c0: 20 63 6f 6c 75 6d 6e 20 64 65 66 69 6e 69 74 69   column definiti
24d0: 6f 6e 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f  on is the name o
24e0: 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 66 6f 6c  f the column fol
24f0: 6c 6f 77 65 64 20 62 79 20 74 68 65 0a 64 61 74  lowed by the.dat
2500: 61 74 79 70 65 20 66 6f 72 20 74 68 61 74 20 63  atype for that c
2510: 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20 6f 6e 65 20  olumn, then one 
2520: 6f 72 20 6d 6f 72 65 20 6f 70 74 69 6f 6e 61 6c  or more optional
2530: 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73 74 72 61 69   column constrai
2540: 6e 74 73 2e 0a 54 68 65 20 64 61 74 61 74 79 70  nts..The datatyp
2550: 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e  e for the column
2560: 20 69 73 20 28 75 73 75 61 6c 6c 79 29 20 69 67   is (usually) ig
2570: 6e 6f 72 65 64 20 61 6e 64 20 6d 61 79 20 62 65  nored and may be
2580: 20 6f 6d 69 74 74 65 64 2e 0a 41 6c 6c 20 69 6e   omitted..All in
2590: 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 73 74 6f  formation is sto
25a0: 72 65 64 20 61 73 20 6e 75 6c 6c 2d 74 65 72 6d  red as null-term
25b0: 69 6e 61 74 65 64 20 73 74 72 69 6e 67 73 2e 0a  inated strings..
25c0: 54 68 65 20 55 4e 49 51 55 45 20 63 6f 6e 73 74  The UNIQUE const
25d0: 72 61 69 6e 74 20 63 61 75 73 65 73 20 61 6e 20  raint causes an 
25e0: 69 6e 64 65 78 20 74 6f 20 62 65 20 63 72 65 61  index to be crea
25f0: 74 65 64 20 6f 6e 20 74 68 65 20 73 70 65 63 69  ted on the speci
2600: 66 69 65 64 0a 63 6f 6c 75 6d 6e 73 2e 20 20 54  fied.columns.  T
2610: 68 69 73 20 69 6e 64 65 78 20 6d 75 73 74 20 63  his index must c
2620: 6f 6e 74 61 69 6e 20 75 6e 69 71 75 65 20 6b 65  ontain unique ke
2630: 79 73 2e 0a 54 68 65 20 44 45 46 41 55 4c 54 20  ys..The DEFAULT 
2640: 63 6f 6e 73 74 72 61 69 6e 74 0a 73 70 65 63 69  constraint.speci
2650: 66 69 65 73 20 61 20 64 65 66 61 75 6c 74 20 76  fies a default v
2660: 61 6c 75 65 20 74 6f 20 75 73 65 20 77 68 65 6e  alue to use when
2670: 20 64 6f 69 6e 67 20 61 6e 20 49 4e 53 45 52 54   doing an INSERT
2680: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 53 70 65 63 69  ..</p>..<p>Speci
2690: 66 79 69 6e 67 20 61 20 50 52 49 4d 41 52 59 20  fying a PRIMARY 
26a0: 4b 45 59 20 6e 6f 72 6d 61 6c 6c 79 20 6a 75 73  KEY normally jus
26b0: 74 20 63 72 65 61 74 65 73 20 61 20 55 4e 49 51  t creates a UNIQ
26c0: 55 45 20 69 6e 64 65 78 0a 6f 6e 20 74 68 65 20  UE index.on the 
26d0: 70 72 69 6d 61 72 79 20 6b 65 79 2e 20 20 48 6f  primary key.  Ho
26e0: 77 65 76 65 72 2c 20 69 66 20 70 72 69 6d 61 72  wever, if primar
26f0: 79 20 6b 65 79 20 69 73 20 6f 6e 20 61 20 73 69  y key is on a si
2700: 6e 67 6c 65 20 63 6f 6c 75 6d 6e 0a 74 68 61 74  ngle column.that
2710: 20 68 61 73 20 64 61 74 61 74 79 70 65 20 49 4e   has datatype IN
2720: 54 45 47 45 52 2c 20 74 68 65 6e 20 74 68 61 74  TEGER, then that
2730: 20 63 6f 6c 75 6d 6e 20 69 73 20 75 73 65 64 20   column is used 
2740: 69 6e 74 65 72 6e 61 6c 6c 79 0a 61 73 20 74 68  internally.as th
2750: 65 20 61 63 74 75 61 6c 20 6b 65 79 20 6f 66 20  e actual key of 
2760: 74 68 65 20 42 2d 54 72 65 65 20 66 6f 72 20 74  the B-Tree for t
2770: 68 65 20 74 61 62 6c 65 2e 20 20 54 68 69 73 20  he table.  This 
2780: 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 63  means that the c
2790: 6f 6c 75 6d 6e 0a 6d 61 79 20 6f 6e 6c 79 20 68  olumn.may only h
27a0: 6f 6c 64 20 75 6e 69 71 75 65 20 69 6e 74 65 67  old unique integ
27b0: 65 72 20 76 61 6c 75 65 73 2e 20 20 28 45 78 63  er values.  (Exc
27c0: 65 70 74 20 66 6f 72 20 74 68 69 73 20 6f 6e 65  ept for this one
27d0: 20 63 61 73 65 2c 0a 53 51 4c 69 74 65 20 69 67   case,.SQLite ig
27e0: 6e 6f 72 65 73 20 74 68 65 20 64 61 74 61 74 79  nores the dataty
27f0: 70 65 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e  pe specification
2800: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 61 6e 64 20   of columns and 
2810: 61 6c 6c 6f 77 73 0a 61 6e 79 20 6b 69 6e 64 20  allows.any kind 
2820: 6f 66 20 64 61 74 61 20 74 6f 20 62 65 20 70 75  of data to be pu
2830: 74 20 69 6e 20 61 20 63 6f 6c 75 6d 6e 20 72 65  t in a column re
2840: 67 61 72 64 6c 65 73 73 20 6f 66 20 69 74 73 20  gardless of its 
2850: 64 65 63 6c 61 72 65 64 0a 64 61 74 61 74 79 70  declared.datatyp
2860: 65 2e 29 20 20 49 66 20 61 20 74 61 62 6c 65 20  e.)  If a table 
2870: 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 6e  does not have an
2880: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
2890: 20 4b 45 59 20 63 6f 6c 75 6d 6e 2c 0a 74 68 65   KEY column,.the
28a0: 6e 20 74 68 65 20 42 2d 54 72 65 65 20 6b 65 79  n the B-Tree key
28b0: 20 77 69 6c 6c 20 62 65 20 61 20 61 75 74 6f 6d   will be a autom
28c0: 61 74 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74  atically generat
28d0: 65 64 20 69 6e 74 65 67 65 72 2e 20 20 54 68 65  ed integer.  The
28e0: 0a 42 2d 54 72 65 65 20 6b 65 79 20 66 6f 72 20  .B-Tree key for 
28f0: 61 20 72 6f 77 20 63 61 6e 20 61 6c 77 61 79 73  a row can always
2900: 20 62 65 20 61 63 63 65 73 73 65 64 20 75 73 69   be accessed usi
2910: 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 0a 73 70  ng one of the.sp
2920: 65 63 69 61 6c 20 6e 61 6d 65 73 20 22 3c 62 3e  ecial names "<b>
2930: 52 4f 57 49 44 3c 2f 62 3e 22 2c 20 22 3c 62 3e  ROWID</b>", "<b>
2940: 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20 22 3c 62  OID</b>", or "<b
2950: 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54  >_ROWID_</b>"..T
2960: 68 69 73 20 69 73 20 74 72 75 65 20 72 65 67 61  his is true rega
2970: 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65  rdless of whethe
2980: 72 20 6f 72 20 6e 6f 74 20 74 68 65 72 65 20 69  r or not there i
2990: 73 20 61 6e 20 49 4e 54 45 47 45 52 0a 50 52 49  s an INTEGER.PRI
29a0: 4d 41 52 59 20 4b 45 59 2e 3c 2f 70 3e 0a 0a 3c  MARY KEY.</p>..<
29b0: 70 3e 49 66 20 74 68 65 20 22 54 45 4d 50 22 20  p>If the "TEMP" 
29c0: 6f 72 20 22 54 45 4d 50 4f 52 41 52 59 22 20 6b  or "TEMPORARY" k
29d0: 65 79 77 6f 72 64 20 6f 63 63 75 72 73 20 69 6e  eyword occurs in
29e0: 20 62 65 74 77 65 65 6e 20 22 43 52 45 41 54 45   between "CREATE
29f0: 22 0a 61 6e 64 20 22 54 41 42 4c 45 22 20 74 68  ".and "TABLE" th
2a00: 65 6e 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  en the table tha
2a10: 74 20 69 73 20 63 72 65 61 74 65 64 20 69 73 20  t is created is 
2a20: 6f 6e 6c 79 20 76 69 73 69 62 6c 65 20 74 6f 20  only visible to 
2a30: 74 68 65 0a 70 72 6f 63 65 73 73 20 74 68 61 74  the.process that
2a40: 20 6f 70 65 6e 65 64 20 74 68 65 20 64 61 74 61   opened the data
2a50: 62 61 73 65 20 61 6e 64 20 69 73 20 61 75 74 6f  base and is auto
2a60: 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65  matically delete
2a70: 64 20 77 68 65 6e 0a 74 68 65 20 64 61 74 61 62  d when.the datab
2a80: 61 73 65 20 69 73 20 63 6c 6f 73 65 64 2e 20 20  ase is closed.  
2a90: 41 6e 79 20 69 6e 64 69 63 65 73 20 63 72 65 61  Any indices crea
2aa0: 74 65 64 20 6f 6e 20 61 20 74 65 6d 70 6f 72 61  ted on a tempora
2ab0: 72 79 20 74 61 62 6c 65 0a 61 72 65 20 61 6c 73  ry table.are als
2ac0: 6f 20 74 65 6d 70 6f 72 61 72 79 2e 20 20 54 65  o temporary.  Te
2ad0: 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 73 20 61  mporary tables a
2ae0: 6e 64 20 69 6e 64 69 63 65 73 20 61 72 65 20 73  nd indices are s
2af0: 74 6f 72 65 64 20 69 6e 20 61 0a 73 65 70 61 72  tored in a.separ
2b00: 61 74 65 20 66 69 6c 65 20 64 69 73 74 69 6e 63  ate file distinc
2b10: 74 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20  t from the main 
2b20: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 3c 2f  database file.</
2b30: 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f  p>..<p>The optio
2b40: 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61  nal conflict-cla
2b50: 75 73 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 61  use following ea
2b60: 63 68 20 63 6f 6e 73 74 72 61 69 6e 74 0a 61 6c  ch constraint.al
2b70: 6c 6f 77 73 20 74 68 65 20 73 70 65 63 69 66 69  lows the specifi
2b80: 63 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61 6c 74  cation of an alt
2b90: 65 72 6e 61 74 69 76 65 20 64 65 66 61 75 6c 74  ernative default
2ba0: 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66  .constraint conf
2bb0: 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20  lict resolution 
2bc0: 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 74 68  algorithm for th
2bd0: 61 74 20 63 6f 6e 73 74 72 61 69 6e 74 2e 0a 54  at constraint..T
2be0: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 61 62  he default is ab
2bf0: 6f 72 74 20 41 42 4f 52 54 2e 20 20 44 69 66 66  ort ABORT.  Diff
2c00: 65 72 65 6e 74 20 63 6f 6e 73 74 72 61 69 6e 74  erent constraint
2c10: 73 20 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d  s within the sam
2c20: 65 0a 74 61 62 6c 65 20 6d 61 79 20 68 61 76 65  e.table may have
2c30: 20 64 69 66 66 65 72 65 6e 74 20 64 65 66 61 75   different defau
2c40: 6c 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f  lt conflict reso
2c50: 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d  lution algorithm
2c60: 73 2e 0a 49 66 20 61 6e 20 43 4f 50 59 2c 20 49  s..If an COPY, I
2c70: 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45  NSERT, or UPDATE
2c80: 20 63 6f 6d 6d 61 6e 64 20 73 70 65 63 69 66 69   command specifi
2c90: 65 73 20 61 20 64 69 66 66 65 72 65 6e 74 20 63  es a different c
2ca0: 6f 6e 66 6c 69 63 74 0a 72 65 73 6f 6c 75 74 69  onflict.resoluti
2cb0: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2c 20 74 68  on algorithm, th
2cc0: 65 6e 20 74 68 61 74 20 61 6c 67 6f 72 69 74 68  en that algorith
2cd0: 6d 20 69 73 20 75 73 65 64 20 69 6e 20 70 6c 61  m is used in pla
2ce0: 63 65 20 6f 66 20 74 68 65 0a 64 65 66 61 75 6c  ce of the.defaul
2cf0: 74 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63  t algorithm spec
2d00: 69 66 69 65 64 20 69 6e 20 74 68 65 20 43 52 45  ified in the CRE
2d10: 41 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d  ATE TABLE statem
2d20: 65 6e 74 2e 0a 53 65 65 20 74 68 65 20 73 65 63  ent..See the sec
2d30: 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68  tion titled.<a h
2d40: 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e  ref="#conflict">
2d50: 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20  ON CONFLICT</a> 
2d60: 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69  for additional i
2d70: 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a  nformation.</p>.
2d80: 0a 3c 70 3e 43 48 45 43 4b 20 63 6f 6e 73 74 72  .<p>CHECK constr
2d90: 61 69 6e 74 73 20 61 72 65 20 69 67 6e 6f 72 65  aints are ignore
2da0: 64 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74  d in the current
2db0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e   implementation.
2dc0: 0a 53 75 70 70 6f 72 74 20 66 6f 72 20 43 48 45  .Support for CHE
2dd0: 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6d  CK constraints m
2de0: 61 79 20 62 65 20 61 64 64 65 64 20 69 6e 20 74  ay be added in t
2df0: 68 65 20 66 75 74 75 72 65 2e 20 20 41 73 20 6f  he future.  As o
2e00: 66 0a 76 65 72 73 69 6f 6e 20 32 2e 33 2e 30 2c  f.version 2.3.0,
2e10: 20 4e 4f 54 20 4e 55 4c 4c 2c 20 50 52 49 4d 41   NOT NULL, PRIMA
2e20: 52 59 20 4b 45 59 2c 20 61 6e 64 20 55 4e 49 51  RY KEY, and UNIQ
2e30: 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61  UE constraints a
2e40: 6c 6c 0a 77 6f 72 6b 2e 3c 2f 70 3e 0a 0a 3c 70  ll.work.</p>..<p
2e50: 3e 54 68 65 72 65 20 61 72 65 20 6e 6f 20 61 72  >There are no ar
2e60: 62 69 74 72 61 72 79 20 6c 69 6d 69 74 73 20 6f  bitrary limits o
2e70: 6e 20 74 68 65 20 6e 75 6d 62 65 72 0a 6f 66 20  n the number.of 
2e80: 63 6f 6c 75 6d 6e 73 20 6f 72 20 6f 6e 20 74 68  columns or on th
2e90: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6e 73  e number of cons
2ea0: 74 72 61 69 6e 74 73 20 69 6e 20 61 20 74 61 62  traints in a tab
2eb0: 6c 65 2e 0a 54 68 65 20 74 6f 74 61 6c 20 61 6d  le..The total am
2ec0: 6f 75 6e 74 20 6f 66 20 64 61 74 61 20 69 6e 20  ount of data in 
2ed0: 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 69 73 20  a single row is 
2ee0: 6c 69 6d 69 74 65 64 20 74 6f 20 61 62 6f 75 74  limited to about
2ef0: 0a 31 20 6d 65 67 61 62 79 74 65 73 2e 20 20 28  .1 megabytes.  (
2f00: 54 68 69 73 20 6c 69 6d 69 74 20 63 61 6e 20 62  This limit can b
2f10: 65 20 69 6e 63 72 65 61 73 65 64 20 74 6f 20 31  e increased to 1
2f20: 36 4d 42 20 62 79 20 63 68 61 6e 67 69 6e 67 0a  6MB by changing.
2f30: 61 20 73 69 6e 67 6c 65 20 23 64 65 66 69 6e 65  a single #define
2f40: 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 63   in the source c
2f50: 6f 64 65 20 61 6e 64 20 72 65 63 6f 6d 70 69 6c  ode and recompil
2f60: 69 6e 67 2e 29 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  ing.)</p>..<p>Th
2f70: 65 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 41  e CREATE TABLE A
2f80: 53 20 66 6f 72 6d 20 64 65 66 69 6e 65 73 20 74  S form defines t
2f90: 68 65 20 74 61 62 6c 65 20 74 6f 20 62 65 0a 74  he table to be.t
2fa0: 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66  he result set of
2fb0: 20 61 20 71 75 65 72 79 2e 20 20 54 68 65 20 6e   a query.  The n
2fc0: 61 6d 65 73 20 6f 66 20 74 68 65 20 74 61 62 6c  ames of the tabl
2fd0: 65 20 63 6f 6c 75 6d 6e 73 20 61 72 65 0a 74 68  e columns are.th
2fe0: 65 20 6e 61 6d 65 73 20 6f 66 20 74 68 65 20 63  e names of the c
2ff0: 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72 65  olumns in the re
3000: 73 75 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  sult.</p>..<p>Th
3010: 65 20 65 78 61 63 74 20 74 65 78 74 0a 6f 66 20  e exact text.of 
3020: 65 61 63 68 20 43 52 45 41 54 45 20 54 41 42 4c  each CREATE TABL
3030: 45 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73  E statement is s
3040: 74 6f 72 65 64 20 69 6e 20 74 68 65 20 3c 62 3e  tored in the <b>
3050: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62  sqlite_master</b
3060: 3e 0a 74 61 62 6c 65 2e 20 20 45 76 65 72 79 74  >.table.  Everyt
3070: 69 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65  ime the database
3080: 20 69 73 20 6f 70 65 6e 65 64 2c 20 61 6c 6c 20   is opened, all 
3090: 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61  CREATE TABLE sta
30a0: 74 65 6d 65 6e 74 73 0a 61 72 65 20 72 65 61 64  tements.are read
30b0: 20 66 72 6f 6d 20 74 68 65 20 3c 62 3e 73 71 6c   from the <b>sql
30c0: 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 20 74  ite_master</b> t
30d0: 61 62 6c 65 20 61 6e 64 20 75 73 65 64 20 74 6f  able and used to
30e0: 20 72 65 67 65 6e 65 72 61 74 65 0a 53 51 4c 69   regenerate.SQLi
30f0: 74 65 27 73 20 69 6e 74 65 72 6e 61 6c 20 72 65  te's internal re
3100: 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20  presentation of 
3110: 74 68 65 20 74 61 62 6c 65 20 6c 61 79 6f 75 74  the table layout
3120: 2e 0a 49 66 20 74 68 65 20 6f 72 69 67 69 6e 61  ..If the origina
3130: 6c 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 61 20  l command was a 
3140: 43 52 45 41 54 45 20 54 41 42 4c 45 20 41 53 20  CREATE TABLE AS 
3150: 74 68 65 6e 20 74 68 65 6e 20 61 6e 20 65 71 75  then then an equ
3160: 69 76 61 6c 65 6e 74 0a 43 52 45 41 54 45 20 54  ivalent.CREATE T
3170: 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 20 69  ABLE statement i
3180: 73 20 73 79 6e 74 68 65 73 69 7a 65 64 20 61 6e  s synthesized an
3190: 64 20 73 74 6f 72 65 20 69 6e 20 3c 62 3e 73 71  d store in <b>sq
31a0: 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a  lite_master</b>.
31b0: 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 68 65 20  in place of the 
31c0: 6f 72 69 67 69 6e 61 6c 20 63 6f 6d 6d 61 6e 64  original command
31d0: 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f  ..</p>.}..Sectio
31e0: 6e 20 7b 43 52 45 41 54 45 20 56 49 45 57 7d 20  n {CREATE VIEW} 
31f0: 7b 63 72 65 61 74 65 76 69 65 77 7d 0a 0a 53 79  {createview}..Sy
3200: 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e  ntax {sql-comman
3210: 64 7d 20 7b 0a 43 52 45 41 54 45 20 56 49 45 57  d} {.CREATE VIEW
3220: 20 3c 76 69 65 77 2d 6e 61 6d 65 3e 20 41 53 20   <view-name> AS 
3230: 3c 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e  <select-statemen
3240: 74 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  t>.}..puts {.<p>
3250: 54 68 65 20 43 52 45 41 54 45 20 56 49 45 57 20  The CREATE VIEW 
3260: 63 6f 6d 6d 61 6e 64 20 61 73 73 69 67 6e 73 20  command assigns 
3270: 61 20 6e 61 6d 65 20 74 6f 20 61 20 70 72 65 2d  a name to a pre-
3280: 70 61 63 6b 61 67 65 64 20 53 45 4c 45 43 54 0a  packaged SELECT.
3290: 73 74 61 74 65 6d 65 6e 74 2e 20 20 4f 6e 63 65  statement.  Once
32a0: 20 74 68 65 20 76 69 65 77 20 69 73 20 63 72 65   the view is cre
32b0: 61 74 65 64 2c 20 69 74 20 63 61 6e 20 62 65 20  ated, it can be 
32c0: 75 73 65 64 20 69 6e 20 74 68 65 20 46 52 4f 4d  used in the FROM
32d0: 20 63 6c 61 75 73 65 0a 6f 66 20 61 6e 6f 74 68   clause.of anoth
32e0: 65 72 20 53 45 4c 45 43 54 20 69 6e 20 70 6c 61  er SELECT in pla
32f0: 63 65 20 6f 66 20 61 20 74 61 62 6c 65 20 6e 61  ce of a table na
3300: 6d 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 59 6f 75  me..</p>..<p>You
3310: 20 63 61 6e 6e 6f 74 20 43 4f 50 59 2c 20 49 4e   cannot COPY, IN
3320: 53 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 61  SERT or UPDATE a
3330: 20 76 69 65 77 2e 20 20 56 69 65 77 73 20 61 72   view.  Views ar
3340: 65 20 72 65 61 64 2d 6f 6e 6c 79 2e 3c 2f 70 3e  e read-only.</p>
3350: 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 44 45 4c 45  .}..Section DELE
3360: 54 45 20 64 65 6c 65 74 65 0a 0a 53 79 6e 74 61  TE delete..Synta
3370: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
3380: 7d 20 7b 0a 44 45 4c 45 54 45 20 46 52 4f 4d 20  } {.DELETE FROM 
3390: 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 57 48  <table-name> [WH
33a0: 45 52 45 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e  ERE <expression>
33b0: 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  ].}..puts {.<p>T
33c0: 68 65 20 44 45 4c 45 54 45 20 63 6f 6d 6d 61 6e  he DELETE comman
33d0: 64 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 6d  d is used to rem
33e0: 6f 76 65 20 72 65 63 6f 72 64 73 20 66 72 6f 6d  ove records from
33f0: 20 61 20 74 61 62 6c 65 2e 0a 54 68 65 20 63 6f   a table..The co
3400: 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20 6f  mmand consists o
3410: 66 20 74 68 65 20 22 44 45 4c 45 54 45 20 46 52  f the "DELETE FR
3420: 4f 4d 22 20 6b 65 79 77 6f 72 64 73 20 66 6f 6c  OM" keywords fol
3430: 6c 6f 77 65 64 20 62 79 0a 74 68 65 20 6e 61 6d  lowed by.the nam
3440: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 66  e of the table f
3450: 72 6f 6d 20 77 68 69 63 68 20 72 65 63 6f 72 64  rom which record
3460: 73 20 61 72 65 20 74 6f 20 62 65 20 72 65 6d 6f  s are to be remo
3470: 76 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 57 69  ved..</p>..<p>Wi
3480: 74 68 6f 75 74 20 61 20 57 48 45 52 45 20 63 6c  thout a WHERE cl
3490: 61 75 73 65 2c 20 61 6c 6c 20 72 6f 77 73 20 6f  ause, all rows o
34a0: 66 20 74 68 65 20 74 61 62 6c 65 20 61 72 65 20  f the table are 
34b0: 72 65 6d 6f 76 65 64 2e 0a 49 66 20 61 20 57 48  removed..If a WH
34c0: 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 73 75  ERE clause is su
34d0: 70 70 6c 69 65 64 2c 20 74 68 65 6e 20 6f 6e 6c  pplied, then onl
34e0: 79 20 74 68 6f 73 65 20 72 6f 77 73 20 74 68 61  y those rows tha
34f0: 74 20 6d 61 74 63 68 0a 74 68 65 20 65 78 70 72  t match.the expr
3500: 65 73 73 69 6f 6e 20 61 72 65 20 72 65 6d 6f 76  ession are remov
3510: 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74  ed.</p>.}...Sect
3520: 69 6f 6e 20 7b 44 52 4f 50 20 49 4e 44 45 58 7d  ion {DROP INDEX}
3530: 20 64 72 6f 70 69 6e 64 65 78 0a 0a 53 79 6e 74   dropindex..Synt
3540: 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d  ax {sql-command}
3550: 20 7b 0a 44 52 4f 50 20 49 4e 44 45 58 20 3c 69   {.DROP INDEX <i
3560: 6e 64 65 78 2d 6e 61 6d 65 3e 0a 7d 0a 0a 70 75  ndex-name>.}..pu
3570: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52 4f 50  ts {.<p>The DROP
3580: 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74   INDEX statement
3590: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74 68 65   consists of the
35a0: 20 6b 65 79 77 6f 72 64 73 20 22 44 52 4f 50 20   keywords "DROP 
35b0: 49 4e 44 45 58 22 20 66 6f 6c 6c 6f 77 65 64 0a  INDEX" followed.
35c0: 62 79 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  by the name of t
35d0: 68 65 20 69 6e 64 65 78 2e 20 20 54 68 65 20 69  he index.  The i
35e0: 6e 64 65 78 20 6e 61 6d 65 64 20 69 73 20 63 6f  ndex named is co
35f0: 6d 70 6c 65 74 65 6c 79 20 72 65 6d 6f 76 65 64  mpletely removed
3600: 20 66 72 6f 6d 0a 74 68 65 20 64 69 73 6b 2e 20   from.the disk. 
3610: 20 54 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f   The only way to
3620: 20 72 65 63 6f 76 65 72 20 74 68 65 20 69 6e 64   recover the ind
3630: 65 78 20 69 73 20 74 6f 20 72 65 65 6e 74 65 72  ex is to reenter
3640: 20 74 68 65 0a 61 70 70 72 6f 70 72 69 61 74 65   the.appropriate
3650: 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 63 6f   CREATE INDEX co
3660: 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65  mmand.</p>.}..Se
3670: 63 74 69 6f 6e 20 7b 44 52 4f 50 20 54 41 42 4c  ction {DROP TABL
3680: 45 7d 20 64 72 6f 70 74 61 62 6c 65 0a 0a 53 79  E} droptable..Sy
3690: 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e  ntax {sql-comman
36a0: 64 7d 20 7b 0a 44 52 4f 50 20 54 41 42 4c 45 20  d} {.DROP TABLE 
36b0: 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 0a 7d 0a 0a  <table-name>.}..
36c0: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52  puts {.<p>The DR
36d0: 4f 50 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65  OP TABLE stateme
36e0: 6e 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  nt consists of t
36f0: 68 65 20 6b 65 79 77 6f 72 64 73 20 22 44 52 4f  he keywords "DRO
3700: 50 20 54 41 42 4c 45 22 20 66 6f 6c 6c 6f 77 65  P TABLE" followe
3710: 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20 6f 66  d.by the name of
3720: 20 74 68 65 20 74 61 62 6c 65 2e 20 20 54 68 65   the table.  The
3730: 20 74 61 62 6c 65 20 6e 61 6d 65 64 20 69 73 20   table named is 
3740: 63 6f 6d 70 6c 65 74 65 6c 79 20 72 65 6d 6f 76  completely remov
3750: 65 64 20 66 72 6f 6d 0a 74 68 65 20 64 69 73 6b  ed from.the disk
3760: 2e 20 20 54 68 65 20 74 61 62 6c 65 20 63 61 6e  .  The table can
3770: 20 6e 6f 74 20 62 65 20 72 65 63 6f 76 65 72 65   not be recovere
3780: 64 2e 20 20 41 6c 6c 20 69 6e 64 69 63 65 73 20  d.  All indices 
3790: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 0a  associated with.
37a0: 74 68 65 20 74 61 62 6c 65 20 61 72 65 20 61 6c  the table are al
37b0: 73 6f 20 64 65 6c 65 74 65 64 2e 3c 2f 70 3e 7d  so deleted.</p>}
37c0: 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20  ..Section {DROP 
37d0: 56 49 45 57 7d 20 64 72 6f 70 76 69 65 77 0a 0a  VIEW} dropview..
37e0: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d  Syntax {sql-comm
37f0: 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 56 49 45 57  and} {.DROP VIEW
3800: 20 3c 76 69 65 77 2d 6e 61 6d 65 3e 0a 7d 0a 0a   <view-name>.}..
3810: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52  puts {.<p>The DR
3820: 4f 50 20 56 49 45 57 20 73 74 61 74 65 6d 65 6e  OP VIEW statemen
3830: 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74 68  t consists of th
3840: 65 20 6b 65 79 77 6f 72 64 73 20 22 44 52 4f 50  e keywords "DROP
3850: 20 54 41 42 4c 45 22 20 66 6f 6c 6c 6f 77 65 64   TABLE" followed
3860: 0a 62 79 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  .by the name of 
3870: 74 68 65 20 76 69 65 77 2e 20 20 54 68 65 20 76  the view.  The v
3880: 69 65 77 20 6e 61 6d 65 64 20 69 73 20 72 65 6d  iew named is rem
3890: 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 64 61  oved from the da
38a0: 74 61 62 61 73 65 2e 0a 42 75 74 20 6e 6f 20 61  tabase..But no a
38b0: 63 74 75 61 6c 20 64 61 74 61 20 69 73 20 6d 6f  ctual data is mo
38c0: 64 69 66 69 65 64 2e 3c 2f 70 3e 7d 0a 0a 53 65  dified.</p>}..Se
38d0: 63 74 69 6f 6e 20 45 58 50 4c 41 49 4e 20 65 78  ction EXPLAIN ex
38e0: 70 6c 61 69 6e 0a 0a 53 79 6e 74 61 78 20 7b 73  plain..Syntax {s
38f0: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
3900: 45 58 50 4c 41 49 4e 20 3c 73 71 6c 2d 73 74 61  EXPLAIN <sql-sta
3910: 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73 20  tement>.}..puts 
3920: 7b 0a 3c 70 3e 54 68 65 20 45 58 50 4c 41 49 4e  {.<p>The EXPLAIN
3930: 20 63 6f 6d 6d 61 6e 64 20 6d 6f 64 69 66 69 65   command modifie
3940: 72 20 69 73 20 61 20 6e 6f 6e 2d 73 74 61 6e 64  r is a non-stand
3950: 61 72 64 20 65 78 74 65 6e 73 69 6f 6e 2e 20 20  ard extension.  
3960: 54 68 65 0a 69 64 65 61 20 63 6f 6d 65 73 20 66  The.idea comes f
3970: 72 6f 6d 20 61 20 73 69 6d 69 6c 61 72 20 63 6f  rom a similar co
3980: 6d 6d 61 6e 64 20 66 6f 75 6e 64 20 69 6e 20 50  mmand found in P
3990: 6f 73 74 67 72 65 53 51 4c 2c 20 62 75 74 20 74  ostgreSQL, but t
39a0: 68 65 20 6f 70 65 72 61 74 69 6f 6e 0a 69 73 20  he operation.is 
39b0: 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 66 66 65  completely diffe
39c0: 72 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66  rent.</p>..<p>If
39d0: 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b 65 79   the EXPLAIN key
39e0: 77 6f 72 64 20 61 70 70 65 61 72 73 20 62 65 66  word appears bef
39f0: 6f 72 65 20 61 6e 79 20 6f 74 68 65 72 20 53 51  ore any other SQ
3a00: 4c 69 74 65 20 53 51 4c 20 63 6f 6d 6d 61 6e 64  Lite SQL command
3a10: 0a 74 68 65 6e 20 69 6e 73 74 65 61 64 20 6f 66  .then instead of
3a20: 20 61 63 74 75 61 6c 6c 79 20 65 78 65 63 75 74   actually execut
3a30: 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2c  ing the command,
3a40: 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72   the SQLite libr
3a50: 61 72 79 20 77 69 6c 6c 0a 72 65 70 6f 72 74 20  ary will.report 
3a60: 62 61 63 6b 20 74 68 65 20 73 65 71 75 65 6e 63  back the sequenc
3a70: 65 20 6f 66 20 76 69 72 74 75 61 6c 20 6d 61 63  e of virtual mac
3a80: 68 69 6e 65 20 69 6e 73 74 72 75 63 74 69 6f 6e  hine instruction
3a90: 73 20 69 74 20 77 6f 75 6c 64 20 68 61 76 65 0a  s it would have.
3aa0: 75 73 65 64 20 74 6f 20 65 78 65 63 75 74 65 20  used to execute 
3ab0: 74 68 65 20 63 6f 6d 6d 61 6e 64 20 68 61 64 20  the command had 
3ac0: 74 68 65 20 45 58 50 4c 41 49 4e 20 6b 65 79 77  the EXPLAIN keyw
3ad0: 6f 72 64 20 6e 6f 74 20 62 65 65 6e 20 70 72 65  ord not been pre
3ae0: 73 65 6e 74 2e 0a 46 6f 72 20 61 64 64 69 74 69  sent..For additi
3af0: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
3b00: 20 61 62 6f 75 74 20 76 69 72 74 75 61 6c 20 6d   about virtual m
3b10: 61 63 68 69 6e 65 20 69 6e 73 74 72 75 63 74 69  achine instructi
3b20: 6f 6e 73 20 73 65 65 0a 74 68 65 20 3c 61 20 68  ons see.the <a h
3b30: 72 65 66 3d 22 61 72 63 68 2e 68 74 6d 6c 22 3e  ref="arch.html">
3b40: 61 72 63 68 69 74 65 63 74 75 72 65 20 64 65 73  architecture des
3b50: 63 72 69 70 74 69 6f 6e 3c 2f 61 3e 20 6f 72 20  cription</a> or 
3b60: 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f  the documentatio
3b70: 6e 0a 6f 6e 20 3c 61 20 68 72 65 66 3d 22 6f 70  n.on <a href="op
3b80: 63 6f 64 65 2e 68 74 6d 6c 22 3e 61 76 61 69 6c  code.html">avail
3b90: 61 62 6c 65 20 6f 70 63 6f 64 65 73 3c 2f 61 3e  able opcodes</a>
3ba0: 20 66 6f 72 20 74 68 65 20 76 69 72 74 75 61 6c   for the virtual
3bb0: 20 6d 61 63 68 69 6e 65 2e 3c 2f 70 3e 0a 7d 0a   machine.</p>.}.
3bc0: 0a 53 65 63 74 69 6f 6e 20 65 78 70 72 65 73 73  .Section express
3bd0: 69 6f 6e 20 65 78 70 72 0a 0a 53 79 6e 74 61 78  ion expr..Syntax
3be0: 20 7b 65 78 70 72 65 73 73 69 6f 6e 7d 20 7b 0a   {expression} {.
3bf0: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 3c 62 69  <expression> <bi
3c00: 6e 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 65 73  nary-op> <expres
3c10: 73 69 6f 6e 3e 20 7c 0a 3c 65 78 70 72 65 73 73  sion> |.<express
3c20: 69 6f 6e 3e 20 3c 6c 69 6b 65 2d 6f 70 3e 20 3c  ion> <like-op> <
3c30: 65 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a 3c 75  expression> |.<u
3c40: 6e 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 65 73  nary-op> <expres
3c50: 73 69 6f 6e 3e 20 7c 0a 28 20 3c 65 78 70 72 65  sion> |.( <expre
3c60: 73 73 69 6f 6e 3e 20 29 20 7c 0a 3c 63 6f 6c 75  ssion> ) |.<colu
3c70: 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 74 61 62 6c  mn-name> |.<tabl
3c80: 65 2d 6e 61 6d 65 3e 20 2e 20 3c 63 6f 6c 75 6d  e-name> . <colum
3c90: 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 6c 69 74 65 72  n-name> |.<liter
3ca0: 61 6c 2d 76 61 6c 75 65 3e 20 7c 0a 3c 66 75 6e  al-value> |.<fun
3cb0: 63 74 69 6f 6e 2d 6e 61 6d 65 3e 20 28 20 3c 65  ction-name> ( <e
3cc0: 78 70 72 2d 6c 69 73 74 3e 20 7c 20 53 54 41 52  xpr-list> | STAR
3cd0: 20 29 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e   ) |.<expression
3ce0: 3e 20 49 53 4e 55 4c 4c 20 7c 0a 3c 65 78 70 72  > ISNULL |.<expr
3cf0: 65 73 73 69 6f 6e 3e 20 4e 4f 54 4e 55 4c 4c 20  ession> NOTNULL 
3d00: 7c 0a 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 5b  |.<expression> [
3d10: 4e 4f 54 5d 20 42 45 54 57 45 45 4e 20 3c 65 78  NOT] BETWEEN <ex
3d20: 70 72 65 73 73 69 6f 6e 3e 20 41 4e 44 20 3c 65  pression> AND <e
3d30: 78 70 72 65 73 73 69 6f 6e 3e 20 7c 0a 3c 65 78  xpression> |.<ex
3d40: 70 72 65 73 73 69 6f 6e 3e 20 5b 4e 4f 54 5d 20  pression> [NOT] 
3d50: 49 4e 20 28 20 3c 76 61 6c 75 65 2d 6c 69 73 74  IN ( <value-list
3d60: 3e 20 29 20 7c 0a 3c 65 78 70 72 65 73 73 69 6f  > ) |.<expressio
3d70: 6e 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28 20 3c 73  n> [NOT] IN ( <s
3d80: 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e  elect-statement>
3d90: 20 29 20 7c 0a 28 20 3c 73 65 6c 65 63 74 2d 73   ) |.( <select-s
3da0: 74 61 74 65 6d 65 6e 74 3e 20 29 0a 7d 20 7b 6c  tatement> ).} {l
3db0: 69 6b 65 2d 6f 70 7d 20 7b 0a 4c 49 4b 45 20 7c  ike-op} {.LIKE |
3dc0: 20 47 4c 4f 42 20 7c 20 4e 4f 54 20 4c 49 4b 45   GLOB | NOT LIKE
3dd0: 20 7c 20 4e 4f 54 20 47 4c 4f 42 0a 7d 0a 0a 70   | NOT GLOB.}..p
3de0: 75 74 73 20 7b 0a 3c 70 3e 54 68 69 73 20 73 65  uts {.<p>This se
3df0: 63 74 69 6f 6e 20 69 73 20 64 69 66 66 65 72 65  ction is differe
3e00: 6e 74 20 66 72 6f 6d 20 74 68 65 20 6f 74 68 65  nt from the othe
3e10: 72 73 2e 20 20 4d 6f 73 74 20 6f 74 68 65 72 20  rs.  Most other 
3e20: 73 65 63 74 69 6f 6e 73 20 6f 66 0a 74 68 69 73  sections of.this
3e30: 20 64 6f 63 75 6d 65 6e 74 20 74 61 6c 6b 73 20   document talks 
3e40: 61 62 6f 75 74 20 61 20 70 61 72 74 69 63 75 6c  about a particul
3e50: 61 72 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 20  ar SQL command. 
3e60: 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 64 6f   This section do
3e70: 65 73 0a 6e 6f 74 20 74 61 6c 6b 20 61 62 6f 75  es.not talk abou
3e80: 74 20 61 20 73 74 61 6e 64 61 6c 6f 6e 65 20 63  t a standalone c
3e90: 6f 6d 6d 61 6e 64 20 62 75 74 20 61 62 6f 75 74  ommand but about
3ea0: 20 22 65 78 70 72 65 73 73 69 6f 6e 73 22 20 77   "expressions" w
3eb0: 68 69 63 68 20 61 72 65 20 0a 73 75 62 63 6f 6d  hich are .subcom
3ec0: 70 6f 6e 65 6e 74 20 6f 66 20 6d 6f 73 74 20 6f  ponent of most o
3ed0: 74 68 65 72 20 63 6f 6d 6d 61 6e 64 73 2e 3c 2f  ther commands.</
3ee0: 70 3e 0a 0a 3c 70 3e 53 51 4c 69 74 65 20 75 6e  p>..<p>SQLite un
3ef0: 64 65 72 73 74 61 6e 64 73 20 74 68 65 20 66 6f  derstands the fo
3f00: 6c 6c 6f 77 69 6e 67 20 62 69 6e 61 72 79 20 6f  llowing binary o
3f10: 70 65 72 61 74 6f 72 73 2c 20 69 6e 20 6f 72 64  perators, in ord
3f20: 65 72 20 66 72 6f 6d 0a 68 69 67 68 65 73 74 20  er from.highest 
3f30: 74 6f 20 6c 6f 77 65 73 74 20 70 72 65 63 65 64  to lowest preced
3f40: 65 6e 63 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63  ence:</p>..<bloc
3f50: 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f  kquote><pre>.<fo
3f60: 6e 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66  nt color="#2c2cf
3f70: 30 22 3e 3c 62 69 67 3e 2a 20 20 20 20 2f 20 20  0"><big>*    /  
3f80: 20 20 25 0a 2b 20 20 20 20 2d 0a 26 6c 74 3b 26    %.+    -.&lt;&
3f90: 6c 74 3b 20 20 20 26 67 74 3b 26 67 74 3b 20 20  lt;   &gt;&gt;  
3fa0: 20 26 61 6d 70 3b 20 20 20 20 7c 0a 26 6c 74 3b   &amp;    |.&lt;
3fb0: 20 20 20 20 26 6c 74 3b 3d 20 20 20 26 67 74 3b      &lt;=   &gt;
3fc0: 20 20 20 20 26 67 74 3b 3d 0a 3d 20 20 20 20 3d      &gt;=.=    =
3fd0: 3d 20 20 20 21 3d 20 20 20 26 6c 74 3b 26 67 74  =   !=   &lt;&gt
3fe0: 3b 20 20 20 3c 2f 62 69 67 3e 49 4e 0a 41 4e 44  ;   </big>IN.AND
3ff0: 0a 4f 52 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72 65  .OR</font>.</pre
4000: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  ></blockquote>..
4010: 3c 70 3e 53 75 70 70 6f 72 74 65 64 20 75 6e 61  <p>Supported una
4020: 72 79 20 6f 70 65 72 61 74 65 72 73 20 61 72 65  ry operaters are
4030: 20 74 68 65 73 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c   these:</p>..<bl
4040: 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 3c  ockquote><pre>.<
4050: 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32  font color="#2c2
4060: 63 66 30 22 3e 3c 62 69 67 3e 2d 20 20 20 20 2b  cf0"><big>-    +
4070: 20 20 20 20 21 20 20 20 20 7e 3c 2f 62 69 67 3e      !    ~</big>
4080: 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72 65 3e 3c 2f  </font>.</pre></
4090: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e  blockquote>..<p>
40a0: 41 6e 79 20 53 51 4c 69 74 65 20 76 61 6c 75 65  Any SQLite value
40b0: 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 73 20   can be used as 
40c0: 70 61 72 74 20 6f 66 20 61 6e 20 65 78 70 72 65  part of an expre
40d0: 73 73 69 6f 6e 2e 20 20 0a 46 6f 72 20 61 72 69  ssion.  .For ari
40e0: 74 68 6d 65 74 69 63 20 6f 70 65 72 61 74 69 6f  thmetic operatio
40f0: 6e 73 2c 20 69 6e 74 65 67 65 72 73 20 61 72 65  ns, integers are
4100: 20 74 72 65 61 74 65 64 20 61 73 20 69 6e 74 65   treated as inte
4110: 67 65 72 73 2e 0a 53 74 72 69 6e 67 73 20 61 72  gers..Strings ar
4120: 65 20 66 69 72 73 74 20 63 6f 6e 76 65 72 74 65  e first converte
4130: 64 20 74 6f 20 72 65 61 6c 20 6e 75 6d 62 65 72  d to real number
4140: 73 20 75 73 69 6e 67 20 3c 62 3e 61 74 6f 66 28  s using <b>atof(
4150: 29 3c 2f 62 3e 2e 0a 46 6f 72 20 63 6f 6d 70 61  )</b>..For compa
4160: 72 69 73 6f 6e 20 6f 70 65 72 61 74 6f 72 73 2c  rison operators,
4170: 20 6e 75 6d 62 65 72 73 20 63 6f 6d 70 61 72 65   numbers compare
4180: 20 61 73 20 6e 75 6d 62 65 72 73 20 61 6e 64 20   as numbers and 
4190: 73 74 72 69 6e 67 73 0a 63 6f 6d 70 61 72 65 20  strings.compare 
41a0: 61 73 20 73 74 72 69 6e 67 73 2e 20 20 46 6f 72  as strings.  For
41b0: 20 73 74 72 69 6e 67 20 63 6f 6d 70 61 72 69 73   string comparis
41c0: 6f 6e 73 2c 20 63 61 73 65 20 69 73 20 73 69 67  ons, case is sig
41d0: 6e 69 66 69 63 61 6e 74 0a 62 75 74 20 69 73 20  nificant.but is 
41e0: 6f 6e 6c 79 20 75 73 65 64 20 74 6f 20 62 72 65  only used to bre
41f0: 61 6b 20 61 20 74 69 65 2e 0a 4e 6f 74 65 20 74  ak a tie..Note t
4200: 68 61 74 20 74 68 65 72 65 20 61 72 65 20 74 77  hat there are tw
4210: 6f 20 76 61 72 69 61 74 69 6f 6e 73 20 6f 66 20  o variations of 
4220: 74 68 65 20 65 71 75 61 6c 73 20 61 6e 64 20 6e  the equals and n
4230: 6f 74 20 65 71 75 61 6c 73 0a 6f 70 65 72 61 74  ot equals.operat
4240: 6f 72 73 2e 20 20 45 71 75 61 6c 73 20 63 61 6e  ors.  Equals can
4250: 20 62 65 20 65 69 74 68 65 72 7d 0a 70 75 74 73   be either}.puts
4260: 20 22 5b 4f 70 65 72 61 74 6f 72 20 3d 5d 20 6f   "[Operator =] o
4270: 72 20 5b 4f 70 65 72 61 74 6f 72 20 3d 3d 5d 2e  r [Operator ==].
4280: 0a 54 68 65 20 6e 6f 6e 2d 65 71 75 61 6c 73 20  .The non-equals 
4290: 6f 70 65 72 61 74 6f 72 20 63 61 6e 20 62 65 20  operator can be 
42a0: 65 69 74 68 65 72 0a 5b 4f 70 65 72 61 74 6f 72  either.[Operator
42b0: 20 21 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74 6f   !=] or [Operato
42c0: 72 20 7b 26 6c 74 3b 26 67 74 3b 7d 5d 2e 3c 2f  r {&lt;&gt;}].</
42d0: 70 3e 22 0a 70 75 74 73 20 7b 0a 0a 3c 70 3e 54  p>".puts {..<p>T
42e0: 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72  he LIKE operator
42f0: 20 64 6f 65 73 20 61 20 77 69 6c 64 63 61 72 64   does a wildcard
4300: 20 63 6f 6d 70 61 72 69 73 69 6f 6e 2e 20 20 54   comparision.  T
4310: 68 65 20 6f 70 65 72 61 6e 64 0a 74 6f 20 74 68  he operand.to th
4320: 65 20 72 69 67 68 74 20 63 6f 6e 74 61 69 6e 73  e right contains
4330: 20 74 68 65 20 77 69 6c 64 63 61 72 64 73 2e 7d   the wildcards.}
4340: 0a 70 75 74 73 20 22 41 20 70 65 72 63 65 6e 74  .puts "A percent
4350: 20 73 79 6d 62 6f 6c 20 5b 4f 70 65 72 61 74 6f   symbol [Operato
4360: 72 20 25 5d 20 69 6e 20 74 68 65 20 72 69 67 68  r %] in the righ
4370: 74 20 6f 70 65 72 61 6e 64 0a 6d 61 74 63 68 65  t operand.matche
4380: 73 20 61 6e 79 20 73 65 71 75 65 6e 63 65 20 6f  s any sequence o
4390: 66 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 63  f zero or more c
43a0: 68 61 72 61 63 74 65 72 73 20 6f 6e 20 74 68 65  haracters on the
43b0: 20 6c 65 66 74 2e 0a 41 6e 20 75 6e 64 65 72 73   left..An unders
43c0: 63 6f 72 65 20 5b 4f 70 65 72 61 74 6f 72 20 5f  core [Operator _
43d0: 5d 20 6f 6e 20 74 68 65 20 72 69 67 68 74 0a 6d  ] on the right.m
43e0: 61 74 63 68 65 73 20 61 6e 79 20 73 69 6e 67 6c  atches any singl
43f0: 65 20 63 68 61 72 61 63 74 65 72 20 6f 6e 20 74  e character on t
4400: 68 65 20 6c 65 66 74 2e 22 0a 70 75 74 73 20 7b  he left.".puts {
4410: 54 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  The LIKE operato
4420: 72 20 69 73 0a 6e 6f 74 20 63 61 73 65 20 73 65  r is.not case se
4430: 6e 73 69 74 69 76 65 20 61 6e 64 20 77 69 6c 6c  nsitive and will
4440: 20 6d 61 74 63 68 20 75 70 70 65 72 20 63 61 73   match upper cas
4450: 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e 20  e characters on 
4460: 6f 6e 65 0a 73 69 64 65 20 61 67 61 69 6e 73 74  one.side against
4470: 20 6c 6f 77 65 72 20 63 61 73 65 20 63 68 61 72   lower case char
4480: 61 63 74 65 72 73 20 6f 6e 20 74 68 65 20 6f 74  acters on the ot
4490: 68 65 72 2e 0a 28 41 20 62 75 67 3a 20 53 51 4c  her..(A bug: SQL
44a0: 69 74 65 20 6f 6e 6c 79 20 75 6e 64 65 72 73 74  ite only underst
44b0: 61 6e 64 73 20 75 70 70 65 72 2f 6c 6f 77 65 72  ands upper/lower
44c0: 20 63 61 73 65 20 66 6f 72 20 37 2d 62 69 74 20   case for 7-bit 
44d0: 4c 61 74 69 6e 0a 63 68 61 72 61 63 74 65 72 73  Latin.characters
44e0: 2e 20 20 48 65 6e 63 65 20 74 68 65 20 4c 49 4b  .  Hence the LIK
44f0: 45 20 6f 70 65 72 61 74 6f 72 20 69 73 20 63 61  E operator is ca
4500: 73 65 20 73 65 6e 73 69 74 69 76 65 20 66 6f 72  se sensitive for
4510: 0a 38 2d 62 69 74 20 69 73 6f 38 38 35 39 20 63  .8-bit iso8859 c
4520: 68 61 72 61 63 74 65 72 73 20 6f 72 20 55 54 46  haracters or UTF
4530: 2d 38 20 63 68 61 72 61 63 74 65 72 73 2e 20 20  -8 characters.  
4540: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 74 68 65  For example,.the
4550: 20 65 78 70 72 65 73 73 69 6f 6e 20 3c 62 3e 27   expression <b>'
4560: 61 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62 73  a'&nbsp;LIKE&nbs
4570: 70 3b 27 41 27 3c 2f 62 3e 20 69 73 20 54 52 55  p;'A'</b> is TRU
4580: 45 20 62 75 74 0a 3c 62 3e 27 26 61 65 6c 69 67  E but.<b>'&aelig
4590: 3b 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62 73  ;'&nbsp;LIKE&nbs
45a0: 70 3b 27 26 41 45 6c 69 67 3b 27 3c 2f 62 3e 20  p;'&AElig;'</b> 
45b0: 69 73 20 46 41 4c 53 45 2e 29 0a 3c 2f 70 3e 0a  is FALSE.).</p>.
45c0: 0a 3c 70 3e 54 68 65 20 47 4c 4f 42 20 6f 70 65  .<p>The GLOB ope
45d0: 72 61 74 6f 72 20 69 73 20 73 69 6d 69 6c 61 72  rator is similar
45e0: 20 74 6f 20 4c 49 4b 45 20 62 75 74 20 75 73 65   to LIKE but use
45f0: 73 20 74 68 65 20 55 6e 69 78 0a 66 69 6c 65 20  s the Unix.file 
4600: 67 6c 6f 62 62 69 6e 67 20 73 79 6e 74 61 78 20  globbing syntax 
4610: 66 6f 72 20 69 74 73 20 77 69 6c 64 63 61 72 64  for its wildcard
4620: 73 2e 20 20 41 6c 73 6f 2c 20 47 4c 4f 42 20 69  s.  Also, GLOB i
4630: 73 20 63 61 73 65 0a 73 65 6e 73 69 74 69 76 65  s case.sensitive
4640: 2c 20 75 6e 6c 69 6b 65 20 4c 49 4b 45 2e 20 20  , unlike LIKE.  
4650: 42 6f 74 68 20 47 4c 4f 42 20 61 6e 64 20 4c 49  Both GLOB and LI
4660: 4b 45 20 6d 61 79 20 62 65 20 70 72 65 63 65 64  KE may be preced
4670: 65 64 20 62 79 0a 74 68 65 20 4e 4f 54 20 6b 65  ed by.the NOT ke
4680: 79 77 6f 72 64 20 74 6f 20 69 6e 76 65 72 74 20  yword to invert 
4690: 74 68 65 20 73 65 6e 73 65 20 6f 66 20 74 68 65  the sense of the
46a0: 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41   test.</p>..<p>A
46b0: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61 6e   column name can
46c0: 20 62 65 20 61 6e 79 20 6f 66 20 74 68 65 20 6e   be any of the n
46d0: 61 6d 65 73 20 64 65 66 69 6e 65 64 20 69 6e 20  ames defined in 
46e0: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
46f0: 0a 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 6f 6e  .statement or on
4700: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  e of the followi
4710: 6e 67 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74  ng special ident
4720: 69 66 69 65 72 73 3a 20 22 3c 62 3e 52 4f 57 49  ifiers: "<b>ROWI
4730: 44 3c 2f 62 3e 22 2c 0a 22 3c 62 3e 4f 49 44 3c  D</b>",."<b>OID<
4740: 2f 62 3e 22 2c 20 6f 72 20 22 3c 62 3e 5f 52 4f  /b>", or "<b>_RO
4750: 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54 68 65 73 65  WID_</b>"..These
4760: 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74 69 66   special identif
4770: 69 65 72 73 20 61 6c 6c 20 64 65 73 63 72 69 62  iers all describ
4780: 65 20 74 68 65 0a 75 6e 69 71 75 65 20 72 61 6e  e the.unique ran
4790: 64 6f 6d 20 69 6e 74 65 67 65 72 20 6b 65 79 20  dom integer key 
47a0: 28 74 68 65 20 22 72 6f 77 20 6b 65 79 22 29 20  (the "row key") 
47b0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
47c0: 65 76 65 72 79 20 0a 72 6f 77 20 6f 66 20 65 76  every .row of ev
47d0: 65 72 79 20 74 61 62 6c 65 2e 0a 54 68 65 20 73  ery table..The s
47e0: 70 65 63 69 61 6c 20 69 64 65 6e 74 69 66 69 65  pecial identifie
47f0: 72 73 20 6f 6e 6c 79 20 72 65 66 65 72 20 74 6f  rs only refer to
4800: 20 74 68 65 20 72 6f 77 20 6b 65 79 20 69 66 20   the row key if 
4810: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
4820: 0a 73 74 61 74 65 6d 65 6e 74 20 64 6f 65 73 20  .statement does 
4830: 6e 6f 74 20 64 65 66 69 6e 65 20 61 20 72 65 61  not define a rea
4840: 6c 20 63 6f 6c 75 6d 6e 20 77 69 74 68 20 74 68  l column with th
4850: 65 20 73 61 6d 65 20 6e 61 6d 65 2e 20 20 52 6f  e same name.  Ro
4860: 77 20 6b 65 79 73 0a 61 63 74 20 6c 69 6b 65 20  w keys.act like 
4870: 72 65 61 64 2d 6f 6e 6c 79 20 63 6f 6c 75 6d 6e  read-only column
4880: 73 2e 20 20 41 20 72 6f 77 20 6b 65 79 20 63 61  s.  A row key ca
4890: 6e 20 62 65 20 75 73 65 64 20 61 6e 79 77 68 65  n be used anywhe
48a0: 72 65 20 61 20 72 65 67 75 6c 61 72 0a 63 6f 6c  re a regular.col
48b0: 75 6d 6e 20 63 61 6e 20 62 65 20 75 73 65 64 2c  umn can be used,
48c0: 20 65 78 63 65 70 74 20 74 68 61 74 20 79 6f 75   except that you
48d0: 20 63 61 6e 6e 6f 74 20 63 68 61 6e 67 65 20 74   cannot change t
48e0: 68 65 20 76 61 6c 75 65 0a 6f 66 20 61 20 72 6f  he value.of a ro
48f0: 77 20 6b 65 79 20 69 6e 20 61 6e 20 55 50 44 41  w key in an UPDA
4900: 54 45 20 6f 72 20 49 4e 53 45 52 54 20 73 74 61  TE or INSERT sta
4910: 74 65 6d 65 6e 74 2e 0a 22 53 45 4c 45 43 54 20  tement.."SELECT 
4920: 2a 20 2e 2e 2e 22 20 64 6f 65 73 20 6e 6f 74 20  * ..." does not 
4930: 72 65 74 75 72 6e 20 74 68 65 20 72 6f 77 20 6b  return the row k
4940: 65 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 45 4c 45  ey.</p>..<p>SELE
4950: 43 54 20 73 74 61 74 65 6d 65 6e 74 73 20 63 61  CT statements ca
4960: 6e 20 61 70 70 65 61 72 20 69 6e 20 65 78 70 72  n appear in expr
4970: 65 73 73 69 6f 6e 73 20 61 73 20 65 69 74 68 65  essions as eithe
4980: 72 20 74 68 65 0a 72 69 67 68 74 2d 68 61 6e 64  r the.right-hand
4990: 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68 65 20   operand of the 
49a0: 49 4e 20 6f 70 65 72 61 74 6f 72 20 6f 72 20 61  IN operator or a
49b0: 73 20 61 20 73 63 61 6c 61 72 20 71 75 61 6e 74  s a scalar quant
49c0: 69 74 79 2e 0a 49 6e 20 62 6f 74 68 20 63 61 73  ity..In both cas
49d0: 65 73 2c 20 74 68 65 20 53 45 4c 45 43 54 20 73  es, the SELECT s
49e0: 68 6f 75 6c 64 20 68 61 76 65 20 6f 6e 6c 79 20  hould have only 
49f0: 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 20  a single column 
4a00: 69 6e 20 69 74 73 0a 72 65 73 75 6c 74 2e 20 20  in its.result.  
4a10: 43 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 73  Compound SELECTs
4a20: 20 28 63 6f 6e 6e 65 63 74 65 64 20 77 69 74 68   (connected with
4a30: 20 6b 65 79 77 6f 72 64 73 20 6c 69 6b 65 20 55   keywords like U
4a40: 4e 49 4f 4e 20 6f 72 0a 45 58 43 45 50 54 29 20  NION or.EXCEPT) 
4a50: 61 72 65 20 61 6c 6c 6f 77 65 64 2e 20 20 41 6e  are allowed.  An
4a60: 79 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  y ORDER BY claus
4a70: 65 20 6f 6e 20 74 68 65 20 73 65 6c 65 63 74 20  e on the select 
4a80: 69 73 20 69 67 6e 6f 72 65 64 2e 0a 41 20 53 45  is ignored..A SE
4a90: 4c 45 43 54 20 69 6e 20 61 6e 20 65 78 70 72 65  LECT in an expre
4aa0: 73 73 69 6f 6e 20 69 73 20 65 76 61 6c 75 61 74  ssion is evaluat
4ab0: 65 64 20 6f 6e 63 65 20 62 65 66 6f 72 65 20 61  ed once before a
4ac0: 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73  ny other process
4ad0: 69 6e 67 0a 69 73 20 70 65 72 66 6f 72 6d 65 64  ing.is performed
4ae0: 2c 20 73 6f 20 6e 6f 6e 65 20 6f 66 20 74 68 65  , so none of the
4af0: 20 65 78 70 72 65 73 73 69 6f 6e 73 20 77 69 74   expressions wit
4b00: 68 69 6e 20 74 68 65 20 73 65 6c 65 63 74 20 69  hin the select i
4b10: 74 73 65 6c 66 20 63 61 6e 0a 72 65 66 65 72 20  tself can.refer 
4b20: 74 6f 20 71 75 61 6e 74 69 74 69 65 73 20 69 6e  to quantities in
4b30: 20 74 68 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20   the containing 
4b40: 65 78 70 72 65 73 73 69 6f 6e 2e 3c 2f 70 3e 0a  expression.</p>.
4b50: 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c 45 43  .<p>When a SELEC
4b60: 54 20 69 73 20 74 68 65 20 72 69 67 68 74 20 6f  T is the right o
4b70: 70 65 72 61 6e 64 20 6f 66 20 74 68 65 20 49 4e  perand of the IN
4b80: 20 6f 70 65 72 61 74 6f 72 2c 20 74 68 65 20 49   operator, the I
4b90: 4e 0a 6f 70 65 72 61 74 6f 72 20 72 65 74 75 72  N.operator retur
4ba0: 6e 73 20 54 52 55 45 20 69 66 20 74 68 65 20 72  ns TRUE if the r
4bb0: 65 73 75 6c 74 20 6f 66 20 74 68 65 20 6c 65 66  esult of the lef
4bc0: 74 20 6f 70 65 72 61 6e 64 20 69 73 20 61 6e 79  t operand is any
4bd0: 20 6f 66 0a 74 68 65 20 76 61 6c 75 65 73 20 67   of.the values g
4be0: 65 6e 65 72 61 74 65 64 20 62 79 20 74 68 65 20  enerated by the 
4bf0: 73 65 6c 65 63 74 2e 20 20 54 68 65 20 49 4e 20  select.  The IN 
4c00: 6f 70 65 72 61 74 6f 72 20 6d 61 79 20 62 65 20  operator may be 
4c10: 70 72 65 63 65 64 65 64 0a 62 79 20 74 68 65 20  preceded.by the 
4c20: 4e 4f 54 20 6b 65 79 77 6f 72 64 20 74 6f 20 69  NOT keyword to i
4c30: 6e 76 65 72 74 20 74 68 65 20 73 65 6e 73 65 20  nvert the sense 
4c40: 6f 66 20 74 68 65 20 74 65 73 74 2e 3c 2f 70 3e  of the test.</p>
4c50: 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c 45  ..<p>When a SELE
4c60: 43 54 20 61 70 70 65 61 72 73 20 77 69 74 68 69  CT appears withi
4c70: 6e 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  n an expression 
4c80: 62 75 74 20 69 73 20 6e 6f 74 20 74 68 65 20 72  but is not the r
4c90: 69 67 68 74 0a 6f 70 65 72 61 6e 64 20 6f 66 20  ight.operand of 
4ca0: 61 6e 20 49 4e 20 6f 70 65 72 61 74 6f 72 2c 20  an IN operator, 
4cb0: 74 68 65 6e 20 74 68 65 20 66 69 72 73 74 20 72  then the first r
4cc0: 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ow of the result
4cd0: 20 6f 66 20 74 68 65 0a 53 45 4c 45 43 54 20 62   of the.SELECT b
4ce0: 65 63 6f 6d 65 73 20 74 68 65 20 76 61 6c 75 65  ecomes the value
4cf0: 20 75 73 65 64 20 69 6e 20 74 68 65 20 65 78 70   used in the exp
4d00: 72 65 73 73 69 6f 6e 2e 20 20 49 66 20 74 68 65  ression.  If the
4d10: 20 53 45 4c 45 43 54 20 79 69 65 6c 64 73 0a 6d   SELECT yields.m
4d20: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 65 73  ore than one res
4d30: 75 6c 74 20 72 6f 77 2c 20 61 6c 6c 20 72 6f 77  ult row, all row
4d40: 73 20 61 66 74 65 72 20 74 68 65 20 66 69 72 73  s after the firs
4d50: 74 20 61 72 65 20 69 67 6e 6f 72 65 64 2e 20 20  t are ignored.  
4d60: 49 66 0a 74 68 65 20 53 45 4c 45 43 54 20 79 65  If.the SELECT ye
4d70: 69 6c 64 73 20 6e 6f 20 72 6f 77 73 2c 20 74 68  ilds no rows, th
4d80: 65 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  en the value of 
4d90: 74 68 65 20 53 45 4c 45 43 54 20 69 73 20 4e 55  the SELECT is NU
4da0: 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 42 6f 74 68  LL.</p>..<p>Both
4db0: 20 73 69 6d 70 6c 65 20 61 6e 64 20 61 67 67 72   simple and aggr
4dc0: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20  egate functions 
4dd0: 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e 20 20  are supported.  
4de0: 41 20 73 69 6d 70 6c 65 0a 66 75 6e 63 74 69 6f  A simple.functio
4df0: 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e  n can be used in
4e00: 20 61 6e 79 20 65 78 70 72 65 73 73 69 6f 6e 2e   any expression.
4e10: 20 20 53 69 6d 70 6c 65 20 66 75 6e 63 74 69 6f    Simple functio
4e20: 6e 73 20 72 65 74 75 72 6e 0a 61 20 72 65 73 75  ns return.a resu
4e30: 6c 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 62  lt immediately b
4e40: 61 73 65 64 20 6f 6e 20 74 68 65 69 72 20 69 6e  ased on their in
4e50: 70 75 74 73 2e 20 20 41 67 67 72 65 67 61 74 65  puts.  Aggregate
4e60: 20 66 75 6e 63 74 69 6f 6e 73 0a 6d 61 79 20 6f   functions.may o
4e70: 6e 6c 79 20 62 65 20 75 73 65 64 20 69 6e 20 61  nly be used in a
4e80: 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e   SELECT statemen
4e90: 74 2e 20 20 41 67 67 72 65 67 61 74 65 20 66 75  t.  Aggregate fu
4ea0: 6e 63 74 69 6f 6e 73 20 63 6f 6d 70 75 74 65 0a  nctions compute.
4eb0: 74 68 65 69 72 20 72 65 73 75 6c 74 20 61 63 72  their result acr
4ec0: 6f 73 73 20 61 6c 6c 20 72 6f 77 73 20 6f 66 20  oss all rows of 
4ed0: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e 3c  the result set.<
4ee0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c  /p>..<p>The foll
4ef0: 6f 77 69 6e 67 20 73 69 6d 70 6c 65 20 66 75 6e  owing simple fun
4f00: 63 74 69 6f 6e 73 20 61 72 65 20 63 75 72 72 65  ctions are curre
4f10: 6e 74 6c 79 20 73 75 70 70 6f 72 74 65 64 3a 3c  ntly supported:<
4f20: 2f 70 3e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72 64  /p>..<table bord
4f30: 65 72 3d 30 20 63 65 6c 6c 70 61 64 64 69 6e 67  er=0 cellpadding
4f40: 3d 31 30 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  =10>.<tr>.<td va
4f50: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
4f60: 3d 22 72 69 67 68 74 22 20 77 69 64 74 68 3d 31  ="right" width=1
4f70: 32 30 3e 61 62 73 28 3c 69 3e 58 3c 2f 69 3e 29  20>abs(<i>X</i>)
4f80: 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e  </td>.<td valign
4f90: 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68  ="top">Return th
4fa0: 65 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75 65  e absolute value
4fb0: 20 6f 66 20 61 72 67 75 6d 65 6e 74 20 3c 69 3e   of argument <i>
4fc0: 58 3c 2f 69 3e 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  X</i>.</td>.</tr
4fd0: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
4fe0: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
4ff0: 72 69 67 68 74 22 3e 63 6f 61 6c 65 73 63 65 28  right">coalesce(
5000: 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c 2f 69  <i>X</i>,<i>Y</i
5010: 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e 0a 3c 74 64 20  >,...)</td>.<td 
5020: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
5030: 75 72 6e 20 61 20 63 6f 70 79 20 6f 66 20 74 68  urn a copy of th
5040: 65 20 66 69 72 73 74 20 6e 6f 6e 2d 4e 55 4c 4c  e first non-NULL
5050: 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 66 0a 61   argument.  If.a
5060: 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65  ll arguments are
5070: 20 4e 55 4c 4c 20 74 68 65 6e 20 4e 55 4c 4c 20   NULL then NULL 
5080: 69 73 20 72 65 74 75 72 6e 65 64 2e 3c 2f 74 64  is returned.</td
5090: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
50a0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
50b0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6c 61 73  lign="right">las
50c0: 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29  t_insert_rowid()
50d0: 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e  </td>.<td valign
50e0: 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68  ="top">Return th
50f0: 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6c  e ROWID of the l
5100: 61 73 74 20 72 6f 77 20 69 6e 73 65 72 74 20 66  ast row insert f
5110: 72 6f 6d 20 74 68 69 73 0a 63 6f 6e 6e 65 63 74  rom this.connect
5120: 69 6f 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62  ion to the datab
5130: 61 73 65 2e 20 20 54 68 69 73 20 69 73 20 74 68  ase.  This is th
5140: 65 20 73 61 6d 65 20 76 61 6c 75 65 20 74 68 61  e same value tha
5150: 74 20 77 6f 75 6c 64 20 62 65 20 72 65 74 75 72  t would be retur
5160: 6e 65 64 0a 66 72 6f 6d 20 74 68 65 20 3c 62 3e  ned.from the <b>
5170: 73 71 6c 69 74 65 5f 6c 61 73 74 5f 69 6e 73 65  sqlite_last_inse
5180: 72 74 5f 72 6f 77 69 64 28 29 3c 2f 62 3e 20 41  rt_rowid()</b> A
5190: 50 49 20 66 75 6e 63 74 69 6f 6e 2e 3c 2f 74 64  PI function.</td
51a0: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
51b0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
51c0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6c 65 6e  lign="right">len
51d0: 67 74 68 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74  gth(<i>X</i>)</t
51e0: 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  d>.<td valign="t
51f0: 6f 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 73  op">Return the s
5200: 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 6f 66 20  tring length of 
5210: 3c 69 3e 58 3c 2f 69 3e 20 69 6e 20 63 68 61 72  <i>X</i> in char
5220: 61 63 74 65 72 73 2e 0a 49 66 20 53 51 4c 69 74  acters..If SQLit
5230: 65 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20  e is configured 
5240: 74 6f 20 73 75 70 70 6f 72 74 20 55 54 46 2d 38  to support UTF-8
5250: 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65  , then the numbe
5260: 72 20 6f 66 20 55 54 46 2d 38 0a 63 68 61 72 61  r of UTF-8.chara
5270: 63 74 65 72 73 20 69 73 20 72 65 74 75 72 6e 65  cters is returne
5280: 64 2c 20 6e 6f 74 20 74 68 65 20 6e 75 6d 62 65  d, not the numbe
5290: 72 20 6f 66 20 62 79 74 65 73 2e 3c 2f 74 64 3e  r of bytes.</td>
52a0: 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64  .</tr>..<tr>.<td
52b0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c   valign="top" al
52c0: 69 67 6e 3d 22 72 69 67 68 74 22 3e 6c 6f 77 65  ign="right">lowe
52d0: 72 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e  r(<i>X</i>)</td>
52e0: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
52f0: 22 3e 52 65 74 75 72 6e 20 61 20 63 6f 70 79 20  ">Return a copy 
5300: 6f 66 20 73 74 72 69 6e 67 20 3c 69 3e 58 3c 2f  of string <i>X</
5310: 69 3e 20 77 69 6c 6c 20 61 6c 6c 20 63 68 61 72  i> will all char
5320: 61 63 74 65 72 73 0a 63 6f 6e 76 65 72 74 65 64  acters.converted
5330: 20 74 6f 20 6c 6f 77 65 72 20 63 61 73 65 2e 20   to lower case. 
5340: 20 54 68 65 20 43 20 6c 69 62 72 61 72 79 20 3c   The C library <
5350: 62 3e 74 6f 6c 6f 77 65 72 28 29 3c 2f 62 3e 20  b>tolower()</b> 
5360: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 0a  routine is used.
5370: 66 6f 72 20 74 68 65 20 63 6f 6e 76 65 72 73 69  for the conversi
5380: 6f 6e 2c 20 77 68 69 63 68 20 6d 65 61 6e 73 20  on, which means 
5390: 74 68 61 74 20 74 68 69 73 20 66 75 6e 63 74 69  that this functi
53a0: 6f 6e 20 6d 69 67 68 74 20 6e 6f 74 0a 77 6f 72  on might not.wor
53b0: 6b 20 63 6f 72 72 65 63 74 6c 79 20 6f 6e 20 55  k correctly on U
53c0: 54 46 2d 38 20 63 68 61 72 61 63 74 65 72 73 2e  TF-8 characters.
53d0: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72  </td>.</tr>..<tr
53e0: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
53f0: 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22  p" align="right"
5400: 3e 6d 61 78 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69  >max(<i>X</i>,<i
5410: 3e 59 3c 2f 69 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e  >Y</i>,...)</td>
5420: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
5430: 22 3e 52 65 74 75 72 6e 20 74 68 65 20 61 72 67  ">Return the arg
5440: 75 6d 65 6e 74 20 77 69 74 68 20 74 68 65 20 6d  ument with the m
5450: 61 78 69 6d 75 6d 20 76 61 6c 75 65 2e 20 20 41  aximum value.  A
5460: 72 67 75 6d 65 6e 74 73 0a 6d 61 79 20 62 65 20  rguments.may be 
5470: 73 74 72 69 6e 67 73 20 69 6e 20 61 64 64 69 74  strings in addit
5480: 69 6f 6e 20 74 6f 20 6e 75 6d 62 65 72 73 2e 20  ion to numbers. 
5490: 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 76 61 6c   The maximum val
54a0: 75 65 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64  ue is determined
54b0: 0a 62 79 20 74 68 65 20 75 73 75 61 6c 20 73 6f  .by the usual so
54c0: 72 74 20 6f 72 64 65 72 2e 20 20 4e 6f 74 65 20  rt order.  Note 
54d0: 74 68 61 74 20 3c 62 3e 6d 61 78 28 29 3c 2f 62  that <b>max()</b
54e0: 3e 20 69 73 20 61 20 73 69 6d 70 6c 65 20 66 75  > is a simple fu
54f0: 6e 63 74 69 6f 6e 20 77 68 65 6e 0a 69 74 20 68  nction when.it h
5500: 61 73 20 32 20 6f 72 20 6d 6f 72 65 20 61 72 67  as 2 or more arg
5510: 75 6d 65 6e 74 73 20 62 75 74 20 63 6f 6e 76 65  uments but conve
5520: 72 74 73 20 74 6f 20 61 6e 20 61 67 67 72 65 67  rts to an aggreg
5530: 61 74 65 20 66 75 6e 63 74 69 6f 6e 20 69 66 20  ate function if 
5540: 67 69 76 65 6e 0a 6f 6e 6c 79 20 61 20 73 69 6e  given.only a sin
5550: 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 74  gle argument.</t
5560: 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c  d>.</tr>..<tr>.<
5570: 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20  td valign="top" 
5580: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d 69  align="right">mi
5590: 6e 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c  n(<i>X</i>,<i>Y<
55a0: 2f 69 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e 0a 3c 74  /i>,...)</td>.<t
55b0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52  d valign="top">R
55c0: 65 74 75 72 6e 20 74 68 65 20 61 72 67 75 6d 65  eturn the argume
55d0: 6e 74 20 77 69 74 68 20 74 68 65 20 6d 69 6e 69  nt with the mini
55e0: 6d 75 6d 20 76 61 6c 75 65 2e 20 20 41 72 67 75  mum value.  Argu
55f0: 6d 65 6e 74 73 0a 6d 61 79 20 62 65 20 73 74 72  ments.may be str
5600: 69 6e 67 73 20 69 6e 20 61 64 64 69 74 69 6f 6e  ings in addition
5610: 20 74 6f 20 6e 75 6d 62 65 72 73 2e 20 20 54 68   to numbers.  Th
5620: 65 20 6d 6d 69 6e 69 6d 75 6d 20 76 61 6c 75 65  e mminimum value
5630: 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 0a 62   is determined.b
5640: 79 20 74 68 65 20 75 73 75 61 6c 20 73 6f 72 74  y the usual sort
5650: 20 6f 72 64 65 72 2e 20 20 4e 6f 74 65 20 74 68   order.  Note th
5660: 61 74 20 3c 62 3e 6d 69 6e 28 29 3c 2f 62 3e 20  at <b>min()</b> 
5670: 69 73 20 61 20 73 69 6d 70 6c 65 20 66 75 6e 63  is a simple func
5680: 74 69 6f 6e 20 77 68 65 6e 0a 69 74 20 68 61 73  tion when.it has
5690: 20 32 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 6d   2 or more argum
56a0: 65 6e 74 73 20 62 75 74 20 63 6f 6e 76 65 72 74  ents but convert
56b0: 73 20 74 6f 20 61 6e 20 61 67 67 72 65 67 61 74  s to an aggregat
56c0: 65 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 67 69  e function if gi
56d0: 76 65 6e 0a 6f 6e 6c 79 20 61 20 73 69 6e 67 6c  ven.only a singl
56e0: 65 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 74 64 3e  e argument.</td>
56f0: 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64  .</tr>..<tr>.<td
5700: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c   valign="top" al
5710: 69 67 6e 3d 22 72 69 67 68 74 22 3e 72 61 6e 64  ign="right">rand
5720: 6f 6d 28 2a 29 3c 2f 74 64 3e 0a 3c 74 64 20 76  om(*)</td>.<td v
5730: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74 75  align="top">Retu
5740: 72 6e 20 61 20 72 61 6e 64 6f 6d 20 69 6e 74 65  rn a random inte
5750: 67 65 72 20 62 65 74 77 65 65 6e 20 2d 32 31 34  ger between -214
5760: 37 34 38 33 36 34 38 20 61 6e 64 0a 2b 32 31 34  7483648 and.+214
5770: 37 34 38 33 36 34 37 2e 3c 2f 74 64 3e 0a 3c 2f  7483647.</td>.</
5780: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
5790: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
57a0: 3d 22 72 69 67 68 74 22 3e 72 6f 75 6e 64 28 3c  ="right">round(<
57b0: 69 3e 58 3c 2f 69 3e 29 3c 62 72 3e 72 6f 75 6e  i>X</i>)<br>roun
57c0: 64 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c  d(<i>X</i>,<i>Y<
57d0: 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61  /i>)</td>.<td va
57e0: 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 6f 75 6e 64  lign="top">Round
57f0: 20 6f 66 66 20 74 68 65 20 6e 75 6d 62 65 72 20   off the number 
5800: 3c 69 3e 58 3c 2f 69 3e 20 74 6f 20 3c 69 3e 59  <i>X</i> to <i>Y
5810: 3c 2f 69 3e 20 64 69 67 69 74 73 20 74 6f 20 74  </i> digits to t
5820: 68 65 0a 72 69 67 68 74 20 6f 66 20 74 68 65 20  he.right of the 
5830: 64 65 63 69 6d 61 6c 20 70 6f 69 6e 74 2e 20 20  decimal point.  
5840: 49 66 20 74 68 65 20 3c 69 3e 59 3c 2f 69 3e 20  If the <i>Y</i> 
5850: 61 72 67 75 6d 65 6e 74 20 69 73 20 6f 6d 69 74  argument is omit
5860: 74 65 64 2c 20 30 20 69 73 20 0a 61 73 73 75 6d  ted, 0 is .assum
5870: 65 64 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a  ed.</td>.</tr>..
5880: 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  <tr>.<td valign=
5890: 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67  "top" align="rig
58a0: 68 74 22 3e 73 75 62 73 74 72 28 3c 69 3e 58 3c  ht">substr(<i>X<
58b0: 2f 69 3e 2c 3c 69 3e 59 3c 2f 69 3e 2c 3c 69 3e  /i>,<i>Y</i>,<i>
58c0: 5a 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  Z</i>)</td>.<td 
58d0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
58e0: 75 72 6e 20 61 20 73 75 62 73 74 72 69 6e 67 20  urn a substring 
58f0: 6f 66 20 69 6e 70 75 74 20 73 74 72 69 6e 67 20  of input string 
5900: 3c 69 3e 58 3c 2f 69 3e 20 74 68 61 74 20 62 65  <i>X</i> that be
5910: 67 69 6e 73 0a 77 69 74 68 20 74 68 65 20 3c 69  gins.with the <i
5920: 3e 59 3c 2f 69 3e 2d 74 68 20 63 68 61 72 61 63  >Y</i>-th charac
5930: 74 65 72 20 61 6e 64 20 77 68 69 63 68 20 69 73  ter and which is
5940: 20 3c 69 3e 5a 3c 2f 69 3e 20 63 68 61 72 61 63   <i>Z</i> charac
5950: 74 65 72 73 20 6c 6f 6e 67 2e 0a 54 68 65 20 6c  ters long..The l
5960: 65 66 74 2d 6d 6f 73 74 20 63 68 61 72 61 63 74  eft-most charact
5970: 65 72 20 6f 66 20 3c 69 3e 58 3c 2f 69 3e 20 69  er of <i>X</i> i
5980: 73 20 6e 75 6d 62 65 72 20 31 2e 20 20 49 66 20  s number 1.  If 
5990: 3c 69 3e 59 3c 2f 69 3e 20 69 73 20 6e 65 67 61  <i>Y</i> is nega
59a0: 74 69 76 65 0a 74 68 65 20 74 68 65 20 66 69 72  tive.the the fir
59b0: 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 66 20  st character of 
59c0: 74 68 65 20 73 75 62 73 74 72 69 6e 67 20 69 73  the substring is
59d0: 20 66 6f 75 6e 64 20 62 79 20 63 6f 75 6e 74 69   found by counti
59e0: 6e 67 20 66 72 6f 6d 20 74 68 65 0a 72 69 67 68  ng from the.righ
59f0: 74 20 72 61 74 68 65 72 20 74 68 61 6e 20 74 68  t rather than th
5a00: 65 20 6c 65 66 74 2e 20 20 49 66 20 53 51 4c 69  e left.  If SQLi
5a10: 74 65 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64  te is configured
5a20: 20 74 6f 20 73 75 70 70 6f 72 74 20 55 54 46 2d   to support UTF-
5a30: 38 2c 0a 74 68 65 6e 20 63 68 61 72 61 63 74 65  8,.then characte
5a40: 72 73 20 69 6e 64 69 63 65 73 20 72 65 66 65 72  rs indices refer
5a50: 20 74 6f 20 61 63 74 75 61 6c 20 55 54 46 2d 38   to actual UTF-8
5a60: 20 63 68 61 72 61 63 74 65 72 73 2c 20 6e 6f 74   characters, not
5a70: 20 62 79 74 65 73 2e 3c 2f 74 64 3e 0a 3c 2f 74   bytes.</td>.</t
5a80: 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c  r>..<tr>.<td val
5a90: 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d  ign="top" align=
5aa0: 22 72 69 67 68 74 22 3e 75 70 70 65 72 28 3c 69  "right">upper(<i
5ab0: 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64  >X</i>)</td>.<td
5ac0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65   valign="top">Re
5ad0: 74 75 72 6e 20 61 20 63 6f 70 79 20 6f 66 20 69  turn a copy of i
5ae0: 6e 70 75 74 20 73 74 72 69 6e 67 20 3c 69 3e 58  nput string <i>X
5af0: 3c 2f 69 3e 20 63 6f 6e 76 65 72 74 65 64 20 74  </i> converted t
5b00: 6f 20 61 6c 6c 0a 75 70 70 65 72 2d 63 61 73 65  o all.upper-case
5b10: 20 6c 65 74 74 65 72 73 2e 20 20 54 68 65 20 69   letters.  The i
5b20: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
5b30: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 75   this function u
5b40: 73 65 73 20 74 68 65 20 43 20 6c 69 62 72 61 72  ses the C librar
5b50: 79 0a 72 6f 75 74 69 6e 65 20 3c 62 3e 74 6f 75  y.routine <b>tou
5b60: 70 70 65 72 28 29 3c 2f 62 3e 20 77 68 69 63 68  pper()</b> which
5b70: 20 6d 65 61 6e 73 20 69 74 20 6d 61 79 20 6e 6f   means it may no
5b80: 74 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79  t work correctly
5b90: 20 6f 6e 20 0a 55 54 46 2d 38 20 73 74 72 69 6e   on .UTF-8 strin
5ba0: 67 73 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c  gs.</td>.</tr>.<
5bb0: 2f 74 61 62 6c 65 3e 0a 0a 3c 70 3e 0a 54 68 65  /table>..<p>.The
5bc0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 67 67 72 65   following aggre
5bd0: 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 61  gate functions a
5be0: 72 65 20 73 75 70 70 6f 72 74 65 64 3a 0a 3c 2f  re supported:.</
5bf0: 70 3e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72 64 65  p>..<table borde
5c00: 72 3d 30 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d  r=0 cellpadding=
5c10: 31 30 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c  10>.<tr>.<td val
5c20: 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d  ign="top" align=
5c30: 22 72 69 67 68 74 22 20 77 69 64 74 68 3d 31 32  "right" width=12
5c40: 30 3e 61 76 67 28 3c 69 3e 58 3c 2f 69 3e 29 3c  0>avg(<i>X</i>)<
5c50: 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  /td>.<td valign=
5c60: 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68 65  "top">Return the
5c70: 20 61 76 65 72 61 67 65 20 76 61 6c 75 65 20 6f   average value o
5c80: 66 20 61 6c 6c 20 3c 69 3e 58 3c 2f 69 3e 20 77  f all <i>X</i> w
5c90: 69 74 68 69 6e 20 61 20 67 72 6f 75 70 2e 3c 2f  ithin a group.</
5ca0: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
5cb0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
5cc0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 63   align="right">c
5cd0: 6f 75 6e 74 28 3c 69 3e 58 3c 2f 69 3e 29 3c 62  ount(<i>X</i>)<b
5ce0: 72 3e 63 6f 75 6e 74 28 2a 29 3c 2f 74 64 3e 0a  r>count(*)</td>.
5cf0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
5d00: 3e 54 68 65 20 66 69 72 73 74 20 66 6f 72 6d 20  >The first form 
5d10: 72 65 74 75 72 6e 20 61 20 63 6f 75 6e 74 20 6f  return a count o
5d20: 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  f the number of 
5d30: 74 69 6d 65 73 0a 74 68 61 74 20 3c 69 3e 58 3c  times.that <i>X<
5d40: 2f 69 3e 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20  /i> is not NULL 
5d50: 69 6e 20 61 20 67 72 6f 75 70 2e 20 20 54 68 65  in a group.  The
5d60: 20 73 65 63 6f 6e 64 20 66 6f 72 6d 20 28 77 69   second form (wi
5d70: 74 68 20 6e 6f 20 61 72 67 75 6d 65 6e 74 29 0a  th no argument).
5d80: 72 65 74 75 72 6e 73 20 74 68 65 20 74 6f 74 61  returns the tota
5d90: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73  l number of rows
5da0: 20 69 6e 20 74 68 65 20 67 72 6f 75 70 2e 3c 2f   in the group.</
5db0: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
5dc0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
5dd0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d   align="right">m
5de0: 61 78 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64  ax(<i>X</i>)</td
5df0: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
5e00: 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 6d 61  p">Return the ma
5e10: 78 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 61  ximum value of a
5e20: 6c 6c 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65  ll values in the
5e30: 20 67 72 6f 75 70 2e 0a 54 68 65 20 75 73 75 61   group..The usua
5e40: 6c 20 73 6f 72 74 20 6f 72 64 65 72 20 69 73 20  l sort order is 
5e50: 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e  used to determin
5e60: 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 2e 3c 2f  e the maximum.</
5e70: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
5e80: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
5e90: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d   align="right">m
5ea0: 69 6e 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64  in(<i>X</i>)</td
5eb0: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
5ec0: 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 6d 69  p">Return the mi
5ed0: 6e 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 61  nimum value of a
5ee0: 6c 6c 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65  ll values in the
5ef0: 20 67 72 6f 75 70 2e 0a 54 68 65 20 75 73 75 61   group..The usua
5f00: 6c 20 73 6f 72 74 20 6f 72 64 65 72 20 69 73 20  l sort order is 
5f10: 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e  used to determin
5f20: 65 20 74 68 65 20 6d 69 6e 69 6d 75 6d 2e 3c 2f  e the minimum.</
5f30: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
5f40: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
5f50: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 73   align="right">s
5f60: 75 6d 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64  um(<i>X</i>)</td
5f70: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
5f80: 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 6e 75  p">Return the nu
5f90: 6d 65 72 69 63 20 73 75 6d 20 6f 66 20 61 6c 6c  meric sum of all
5fa0: 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 67   values in the g
5fb0: 72 6f 75 70 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e  roup.</td>.</tr>
5fc0: 0a 3c 2f 74 61 62 6c 65 3e 0a 7d 0a 0a 53 65 63  .</table>.}..Sec
5fd0: 74 69 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73 65  tion INSERT inse
5fe0: 72 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  rt..Syntax {sql-
5ff0: 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e 53  statement} {.INS
6000: 45 52 54 20 5b 4f 52 20 3c 63 6f 6e 66 6c 69 63  ERT [OR <conflic
6010: 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 5d 20 49 4e  t-algorithm>] IN
6020: 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  TO <table-name> 
6030: 5b 28 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 29  [(<column-list>)
6040: 5d 20 56 41 4c 55 45 53 28 3c 76 61 6c 75 65 2d  ] VALUES(<value-
6050: 6c 69 73 74 3e 29 20 7c 0a 49 4e 53 45 52 54 20  list>) |.INSERT 
6060: 5b 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c  [OR <conflict-al
6070: 67 6f 72 69 74 68 6d 3e 5d 20 49 4e 54 4f 20 3c  gorithm>] INTO <
6080: 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 3c 63  table-name> [(<c
6090: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 29 5d 20 3c 73  olumn-list>)] <s
60a0: 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e  elect-statement>
60b0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
60c0: 65 20 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65  e INSERT stateme
60d0: 6e 74 20 63 6f 6d 65 73 20 69 6e 20 74 77 6f 20  nt comes in two 
60e0: 62 61 73 69 63 20 66 6f 72 6d 73 2e 20 20 54 68  basic forms.  Th
60f0: 65 20 66 69 72 73 74 20 66 6f 72 6d 0a 28 77 69  e first form.(wi
6100: 74 68 20 74 68 65 20 22 56 41 4c 55 45 53 22 20  th the "VALUES" 
6110: 6b 65 79 77 6f 72 64 29 20 63 72 65 61 74 65 73  keyword) creates
6120: 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 20 72 6f   a single new ro
6130: 77 20 69 6e 20 61 6e 20 65 78 69 73 74 69 6e 67  w in an existing
6140: 20 74 61 62 6c 65 2e 0a 49 66 20 6e 6f 20 63 6f   table..If no co
6150: 6c 75 6d 6e 2d 6c 69 73 74 20 69 73 20 73 70 65  lumn-list is spe
6160: 63 69 66 69 65 64 20 74 68 65 6e 20 74 68 65 20  cified then the 
6170: 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73  number of values
6180: 20 6d 75 73 74 0a 62 65 20 74 68 65 20 73 61 6d   must.be the sam
6190: 65 20 61 73 20 74 68 65 20 6e 75 6d 62 65 72 20  e as the number 
61a0: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
61b0: 65 20 74 61 62 6c 65 2e 20 20 49 66 20 61 20 63  e table.  If a c
61c0: 6f 6c 75 6d 6e 2d 6c 69 73 74 0a 69 73 20 73 70  olumn-list.is sp
61d0: 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 74 68  ecified, then th
61e0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75  e number of valu
61f0: 65 73 20 6d 75 73 74 20 6d 61 74 63 68 20 74 68  es must match th
6200: 65 20 6e 75 6d 62 65 72 20 6f 66 0a 73 70 65 63  e number of.spec
6210: 69 66 69 65 64 20 63 6f 6c 75 6d 6e 73 2e 20 20  ified columns.  
6220: 43 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20 74  Columns of the t
6230: 61 62 6c 65 20 74 68 61 74 20 64 6f 20 6e 6f 74  able that do not
6240: 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 0a 63   appear in the.c
6250: 6f 6c 75 6d 6e 20 6c 69 73 74 20 61 72 65 20 66  olumn list are f
6260: 69 6c 6c 20 77 69 74 68 20 74 68 65 20 64 65 66  ill with the def
6270: 61 75 6c 74 20 76 61 6c 75 65 2c 20 6f 72 20 77  ault value, or w
6280: 69 74 68 20 4e 55 4c 4c 20 69 66 20 6e 6f 74 0a  ith NULL if not.
6290: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73  default value is
62a0: 20 73 70 65 63 69 66 69 65 64 2e 0a 3c 2f 70 3e   specified..</p>
62b0: 0a 0a 3c 70 3e 54 68 65 20 73 65 63 6f 6e 64 20  ..<p>The second 
62c0: 66 6f 72 6d 20 6f 66 20 74 68 65 20 49 4e 53 45  form of the INSE
62d0: 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 61 6b  RT statement tak
62e0: 65 73 20 69 74 20 64 61 74 61 20 66 72 6f 6d 20  es it data from 
62f0: 61 0a 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  a.SELECT stateme
6300: 6e 74 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20  nt.  The number 
6310: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
6320: 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 0a  e result of the.
6330: 53 45 4c 45 43 54 20 6d 75 73 74 20 65 78 61 63  SELECT must exac
6340: 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 6e 75  tly match the nu
6350: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
6360: 69 6e 20 74 68 65 20 74 61 62 6c 65 20 69 66 0a  in the table if.
6370: 6e 6f 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 69  no column list i
6380: 73 20 73 70 65 63 69 66 69 65 64 2c 20 6f 72 20  s specified, or 
6390: 69 74 20 6d 75 73 74 20 6d 61 74 63 68 20 74 68  it must match th
63a0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  e number of colu
63b0: 6d 6e 73 0a 6e 61 6d 65 20 69 6e 20 74 68 65 20  mns.name in the 
63c0: 63 6f 6c 75 6d 6e 20 6c 69 73 74 2e 20 20 41 20  column list.  A 
63d0: 6e 65 77 20 65 6e 74 72 79 20 69 73 20 6d 61 64  new entry is mad
63e0: 65 20 69 6e 20 74 68 65 20 74 61 62 6c 65 0a 66  e in the table.f
63f0: 6f 72 20 65 76 65 72 79 20 72 6f 77 20 6f 66 20  or every row of 
6400: 74 68 65 20 53 45 4c 45 43 54 20 72 65 73 75 6c  the SELECT resul
6410: 74 2e 20 20 54 68 65 20 53 45 4c 45 43 54 20 6d  t.  The SELECT m
6420: 61 79 20 62 65 20 73 69 6d 70 6c 65 0a 6f 72 20  ay be simple.or 
6430: 63 6f 6d 70 6f 75 6e 64 2e 20 20 49 66 20 74 68  compound.  If th
6440: 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  e SELECT stateme
6450: 6e 74 20 68 61 73 20 61 6e 20 4f 52 44 45 52 20  nt has an ORDER 
6460: 42 59 20 63 6c 61 75 73 65 2c 0a 74 68 65 20 4f  BY clause,.the O
6470: 52 44 45 52 20 42 59 20 69 73 20 69 67 6e 6f 72  RDER BY is ignor
6480: 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  ed.</p>..<p>The 
6490: 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63  optional conflic
64a0: 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20  t-clause allows 
64b0: 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69 6f  the specificatio
64c0: 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74  n of an alternat
64d0: 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63  ive.constraint c
64e0: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
64f0: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20  on algorithm to 
6500: 75 73 65 20 64 75 72 69 6e 67 20 74 68 69 73 20  use during this 
6510: 6f 6e 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65  one command..See
6520: 20 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74   the section tit
6530: 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f  led.<a href="#co
6540: 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c  nflict">ON CONFL
6550: 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69  ICT</a> for addi
6560: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
6570: 6f 6e 2e 0a 46 6f 72 20 63 6f 6d 70 61 74 69 62  on..For compatib
6580: 69 6c 69 74 79 20 77 69 74 68 20 4d 79 53 51 4c  ility with MySQL
6590: 2c 20 74 68 65 20 70 61 72 73 65 72 20 61 6c 6c  , the parser all
65a0: 6f 77 73 20 74 68 65 20 75 73 65 20 6f 66 20 74  ows the use of t
65b0: 68 65 0a 73 69 6e 67 6c 65 20 6b 65 79 77 6f 72  he.single keywor
65c0: 64 20 22 52 45 50 4c 41 43 45 22 20 61 73 20 61  d "REPLACE" as a
65d0: 6e 20 61 6c 69 61 73 20 66 6f 72 20 22 49 4e 53  n alias for "INS
65e0: 45 52 54 20 4f 52 20 52 45 50 4c 41 43 45 22 2e  ERT OR REPLACE".
65f0: 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
6600: 20 7b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c   {ON CONFLICT cl
6610: 61 75 73 65 7d 20 63 6f 6e 66 6c 69 63 74 0a 0a  ause} conflict..
6620: 53 79 6e 74 61 78 20 7b 63 6f 6e 66 6c 69 63 74  Syntax {conflict
6630: 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f 4e 20 43 4f  -clause} {.ON CO
6640: 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63 74  NFLICT <conflict
6650: 2d 61 6c 67 6f 72 69 74 68 6d 3e 0a 7d 20 7b 63  -algorithm>.} {c
6660: 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68  onflict-algorith
6670: 6d 7d 20 7b 0a 52 4f 4c 4c 42 41 43 4b 20 7c 20  m} {.ROLLBACK | 
6680: 41 42 4f 52 54 20 7c 20 46 41 49 4c 20 7c 20 49  ABORT | FAIL | I
6690: 47 4e 4f 52 45 20 7c 20 52 45 50 4c 41 43 45 0a  GNORE | REPLACE.
66a0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
66b0: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
66c0: 75 73 65 20 69 73 20 6e 6f 74 20 61 20 73 65 70  use is not a sep
66d0: 61 72 61 74 65 20 53 51 4c 20 63 6f 6d 6d 61 6e  arate SQL comman
66e0: 64 2e 20 20 49 74 20 69 73 20 61 0a 6e 6f 6e 2d  d.  It is a.non-
66f0: 73 74 61 6e 64 61 72 64 20 63 6c 61 75 73 65 20  standard clause 
6700: 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72 20  that can appear 
6710: 69 6e 20 6d 61 6e 79 20 6f 74 68 65 72 20 53 51  in many other SQ
6720: 4c 20 63 6f 6d 6d 61 6e 64 73 2e 0a 49 74 20 69  L commands..It i
6730: 73 20 67 69 76 65 6e 20 69 74 73 20 6f 77 6e 20  s given its own 
6740: 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 69 73 20  section in this 
6750: 64 6f 63 75 6d 65 6e 74 20 62 65 63 61 75 73 65  document because
6760: 20 69 74 20 69 73 20 6e 6f 74 0a 70 61 72 74 20   it is not.part 
6770: 6f 66 20 73 74 61 6e 64 61 72 64 20 53 51 4c 20  of standard SQL 
6780: 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 6d 69  and therefore mi
6790: 67 68 74 20 6e 6f 74 20 62 65 20 66 61 6d 69 6c  ght not be famil
67a0: 69 61 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  iar.</p>..<p>The
67b0: 20 73 79 6e 74 61 78 20 66 6f 72 20 74 68 65 20   syntax for the 
67c0: 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75  ON CONFLICT clau
67d0: 73 65 20 69 73 20 61 73 20 73 68 6f 77 6e 20 61  se is as shown a
67e0: 62 6f 76 65 20 66 6f 72 0a 74 68 65 20 43 52 45  bove for.the CRE
67f0: 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54  ATE TABLE, CREAT
6800: 45 20 49 4e 44 45 58 2c 20 61 6e 64 20 42 45 47  E INDEX, and BEG
6810: 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63  IN TRANSACTION c
6820: 6f 6d 6d 61 6e 64 73 2e 0a 46 6f 72 20 74 68 65  ommands..For the
6830: 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20 61   COPY, INSERT, a
6840: 6e 64 20 55 50 44 41 54 45 20 63 6f 6d 6d 61 6e  nd UPDATE comman
6850: 64 73 2c 20 74 68 65 20 6b 65 79 77 6f 72 64 73  ds, the keywords
6860: 0a 22 4f 4e 20 43 4f 4e 46 4c 49 43 54 22 20 61  ."ON CONFLICT" a
6870: 72 65 20 72 65 70 6c 61 63 65 64 20 62 79 20 22  re replaced by "
6880: 4f 52 22 2c 20 74 6f 20 6d 61 6b 65 20 74 68 65  OR", to make the
6890: 20 73 79 6e 74 61 78 20 73 65 65 6d 20 6d 6f 72   syntax seem mor
68a0: 65 0a 6e 61 74 75 72 61 6c 2e 20 20 42 75 74 20  e.natural.  But 
68b0: 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74  the meaning of t
68c0: 68 65 20 63 6c 61 75 73 65 20 69 73 20 74 68 65  he clause is the
68d0: 20 73 61 6d 65 20 65 69 74 68 65 72 20 77 61 79   same either way
68e0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f 4e  .</p>..<p>The ON
68f0: 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65   CONFLICT clause
6900: 20 73 70 65 63 69 66 69 65 73 20 61 6e 20 61 6c   specifies an al
6910: 67 6f 72 69 74 68 6d 20 75 73 65 64 20 74 6f 20  gorithm used to 
6920: 72 65 73 6f 6c 76 65 0a 63 6f 6e 73 74 72 61 69  resolve.constrai
6930: 6e 74 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20 54  nt conflicts.  T
6940: 68 65 72 65 20 61 72 65 20 66 69 76 65 20 63 68  here are five ch
6950: 6f 69 63 65 73 3a 20 52 4f 4c 4c 42 41 43 4b 2c  oices: ROLLBACK,
6960: 20 41 42 4f 52 54 2c 0a 46 41 49 4c 2c 20 49 47   ABORT,.FAIL, IG
6970: 4e 4f 52 45 2c 20 61 6e 64 20 52 45 50 4c 41 43  NORE, and REPLAC
6980: 45 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 61  E. The default a
6990: 6c 67 6f 72 69 74 68 6d 20 69 73 20 41 42 4f 52  lgorithm is ABOR
69a0: 54 2e 20 20 54 68 69 73 0a 69 73 20 77 68 61 74  T.  This.is what
69b0: 20 74 68 65 79 20 6d 65 61 6e 3a 3c 2f 70 3e 0a   they mean:</p>.
69c0: 0a 3c 64 6c 3e 0a 3c 64 74 3e 3c 62 3e 52 4f 4c  .<dl>.<dt><b>ROL
69d0: 4c 42 41 43 4b 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c  LBACK</b></dt>.<
69e0: 64 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e  dd><p>When a con
69f0: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
6a00: 6e 20 6f 63 63 75 72 73 2c 20 61 6e 20 69 6d 6d  n occurs, an imm
6a10: 65 64 69 61 74 65 20 52 4f 4c 4c 42 41 43 4b 0a  ediate ROLLBACK.
6a20: 6f 63 63 75 72 73 2c 20 74 68 75 73 20 65 6e 64  occurs, thus end
6a30: 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20  ing the current 
6a40: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e 64  transaction, and
6a50: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 62 6f   the command abo
6a60: 72 74 73 0a 77 69 74 68 20 61 20 72 65 74 75 72  rts.with a retur
6a70: 6e 20 63 6f 64 65 20 6f 66 20 53 51 4c 49 54 45  n code of SQLITE
6a80: 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20 20 49 66  _CONSTRAINT.  If
6a90: 20 6e 6f 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   no transaction 
6aa0: 69 73 0a 61 63 74 69 76 65 20 28 6f 74 68 65 72  is.active (other
6ab0: 20 74 68 61 6e 20 74 68 65 20 69 6d 70 6c 69 65   than the implie
6ac0: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 68  d transaction th
6ad0: 61 74 20 69 73 20 63 72 65 61 74 65 64 20 6f 6e  at is created on
6ae0: 20 65 76 65 72 79 0a 63 6f 6d 6d 61 6e 64 29 20   every.command) 
6af0: 74 68 65 6e 20 74 68 69 73 20 61 6c 67 6f 72 69  then this algori
6b00: 74 68 6d 20 77 6f 72 6b 73 20 74 68 65 20 73 61  thm works the sa
6b10: 6d 65 20 61 73 20 41 42 4f 52 54 2e 3c 2f 70 3e  me as ABORT.</p>
6b20: 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 41 42  </dd>..<dt><b>AB
6b30: 4f 52 54 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64  ORT</b></dt>.<dd
6b40: 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74  ><p>When a const
6b50: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
6b60: 6f 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d  occurs, the comm
6b70: 61 6e 64 20 62 61 63 6b 73 20 6f 75 74 0a 61 6e  and backs out.an
6b80: 79 20 70 72 69 6f 72 20 63 68 61 6e 67 65 73 20  y prior changes 
6b90: 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 6d 61  it might have ma
6ba0: 64 65 20 61 6e 64 20 61 62 6f 72 74 73 20 77 69  de and aborts wi
6bb0: 74 68 20 61 20 72 65 74 75 72 6e 20 63 6f 64 65  th a return code
6bc0: 0a 6f 66 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54  .of SQLITE_CONST
6bd0: 52 41 49 4e 54 2e 20 20 42 75 74 20 6e 6f 20 52  RAINT.  But no R
6be0: 4f 4c 4c 42 41 43 4b 20 69 73 20 65 78 65 63 75  OLLBACK is execu
6bf0: 74 65 64 20 73 6f 20 63 68 61 6e 67 65 73 0a 66  ted so changes.f
6c00: 72 6f 6d 20 70 72 69 6f 72 20 63 6f 6d 6d 61 6e  rom prior comman
6c10: 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 73 61  ds within the sa
6c20: 6d 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 61  me transaction.a
6c30: 72 65 20 70 72 65 73 65 72 76 65 64 2e 20 20 54  re preserved.  T
6c40: 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75  his is the defau
6c50: 6c 74 20 62 65 68 61 76 69 6f 72 2e 3c 2f 70 3e  lt behavior.</p>
6c60: 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 46 41  </dd>..<dt><b>FA
6c70: 49 4c 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e  IL</b></dt>.<dd>
6c80: 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74 72  <p>When a constr
6c90: 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 6f  aint violation o
6ca0: 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d 61  ccurs, the comma
6cb0: 6e 64 20 61 62 6f 72 74 73 20 77 69 74 68 20 61  nd aborts with a
6cc0: 0a 72 65 74 75 72 6e 20 63 6f 64 65 20 53 51 4c  .return code SQL
6cd0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20  ITE_CONSTRAINT. 
6ce0: 20 42 75 74 20 61 6e 79 20 63 68 61 6e 67 65 73   But any changes
6cf0: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65   to the database
6d00: 20 74 68 61 74 0a 74 68 65 20 63 6f 6d 6d 61 6e   that.the comman
6d10: 64 20 6d 61 64 65 20 70 72 69 6f 72 20 74 6f 20  d made prior to 
6d20: 65 6e 63 6f 75 6e 74 65 72 69 6e 67 20 74 68 65  encountering the
6d30: 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c   constraint viol
6d40: 61 74 69 6f 6e 0a 61 72 65 20 70 72 65 73 65 72  ation.are preser
6d50: 76 65 64 20 61 6e 64 20 61 72 65 20 6e 6f 74 20  ved and are not 
6d60: 62 61 63 6b 65 64 20 6f 75 74 2e 20 20 46 6f 72  backed out.  For
6d70: 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 6e 20   example, if an 
6d80: 55 50 44 41 54 45 0a 73 74 61 74 65 6d 65 6e 74  UPDATE.statement
6d90: 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 20 63   encountered a c
6da0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
6db0: 69 6f 6e 20 6f 6e 20 74 68 65 20 31 30 30 74 68  ion on the 100th
6dc0: 20 72 6f 77 20 74 68 61 74 0a 69 74 20 61 74 74   row that.it att
6dd0: 65 6d 70 74 73 20 74 6f 20 75 70 64 61 74 65 2c  empts to update,
6de0: 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 74 20   then the first 
6df0: 39 39 20 72 6f 77 20 63 68 61 6e 67 65 73 20 61  99 row changes a
6e00: 72 65 20 70 72 65 73 65 72 76 65 64 0a 62 75 74  re preserved.but
6e10: 20 63 68 61 6e 67 65 73 20 74 6f 20 72 6f 77 73   changes to rows
6e20: 20 31 30 30 20 61 6e 64 20 62 65 79 6f 6e 64 20   100 and beyond 
6e30: 6e 65 76 65 72 20 6f 63 63 75 72 2e 3c 2f 70 3e  never occur.</p>
6e40: 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 49 47  </dd>..<dt><b>IG
6e50: 4e 4f 52 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64  NORE</b></dt>.<d
6e60: 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73  d><p>When a cons
6e70: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e  traint violation
6e80: 20 6f 63 63 75 72 73 2c 20 74 68 65 20 6f 6e 65   occurs, the one
6e90: 20 72 6f 77 20 74 68 61 74 20 63 6f 6e 74 61 69   row that contai
6ea0: 6e 73 0a 74 68 65 20 63 6f 6e 73 74 72 61 69 6e  ns.the constrain
6eb0: 74 20 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 6e  t violation is n
6ec0: 6f 74 20 69 6e 73 65 72 74 65 64 20 6f 72 20 63  ot inserted or c
6ed0: 68 61 6e 67 65 64 2e 20 20 42 75 74 20 74 68 65  hanged.  But the
6ee0: 20 63 6f 6d 6d 61 6e 64 0a 63 6f 6e 74 69 6e 75   command.continu
6ef0: 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e 6f 72  es executing nor
6f00: 6d 61 6c 6c 79 2e 20 20 4f 74 68 65 72 20 72 6f  mally.  Other ro
6f10: 77 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66  ws before and af
6f20: 74 65 72 20 74 68 65 20 72 6f 77 20 74 68 61 74  ter the row that
6f30: 0a 63 6f 6e 74 61 69 6e 65 64 20 74 68 65 20 63  .contained the c
6f40: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
6f50: 69 6f 6e 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20  ion continue to 
6f60: 62 65 20 69 6e 73 65 72 74 65 64 20 6f 72 20 75  be inserted or u
6f70: 70 64 61 74 65 64 0a 6e 6f 72 6d 61 6c 6c 79 2e  pdated.normally.
6f80: 20 20 4e 6f 20 65 72 72 6f 72 20 69 73 20 72 65    No error is re
6f90: 74 75 72 6e 65 64 2e 3c 2f 70 3e 3c 2f 64 64 3e  turned.</p></dd>
6fa0: 0a 0a 3c 64 74 3e 3c 62 3e 52 45 50 4c 41 43 45  ..<dt><b>REPLACE
6fb0: 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70  </b></dt>.<dd><p
6fc0: 3e 57 68 65 6e 20 61 20 55 4e 49 51 55 45 20 63  >When a UNIQUE c
6fd0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
6fe0: 69 6f 6e 20 6f 63 63 75 72 73 2c 20 74 68 65 20  ion occurs, the 
6ff0: 70 72 65 2d 65 78 69 73 74 69 6e 67 20 72 6f 77  pre-existing row
7000: 0a 74 68 61 74 20 69 73 20 63 61 75 73 69 6e 67  .that is causing
7010: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20   the constraint 
7020: 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 72 65 6d  violation is rem
7030: 6f 76 65 64 20 70 72 69 6f 72 20 74 6f 20 69 6e  oved prior to in
7040: 73 65 72 74 69 6e 67 0a 6f 72 20 75 70 64 61 74  serting.or updat
7050: 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20  ing the current 
7060: 72 6f 77 2e 20 20 54 68 75 73 20 74 68 65 20 69  row.  Thus the i
7070: 6e 73 65 72 74 20 6f 72 20 75 70 64 61 74 65 20  nsert or update 
7080: 61 6c 77 61 79 73 20 6f 63 63 75 72 73 2e 0a 54  always occurs..T
7090: 68 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 74 69  he command conti
70a0: 6e 75 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e  nues executing n
70b0: 6f 72 6d 61 6c 6c 79 2e 20 20 4e 6f 20 65 72 72  ormally.  No err
70c0: 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 2e 3c  or is returned.<
70d0: 2f 70 3e 0a 3c 70 3e 49 66 20 61 20 4e 4f 54 20  /p>.<p>If a NOT 
70e0: 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20  NULL constraint 
70f0: 76 69 6f 6c 61 74 69 6f 6e 20 6f 63 63 75 72 73  violation occurs
7100: 2c 20 74 68 65 20 4e 55 4c 4c 20 76 61 6c 75 65  , the NULL value
7110: 20 69 73 20 72 65 70 6c 61 63 65 64 0a 62 79 20   is replaced.by 
7120: 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75  the default valu
7130: 65 20 66 6f 72 20 74 68 61 74 20 63 6f 6c 75 6d  e for that colum
7140: 6e 2e 20 20 49 66 20 74 68 65 20 63 6f 6c 75 6d  n.  If the colum
7150: 6e 20 68 61 73 20 6e 6f 20 64 65 66 61 75 6c 74  n has no default
7160: 0a 76 61 6c 75 65 2c 20 74 68 65 6e 20 74 68 65  .value, then the
7170: 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68 6d   ABORT algorithm
7180: 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 3c 2f   is used.</p>.</
7190: 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 70 3e 0a 54  dd>.</dl>..<p>.T
71a0: 68 65 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f  he conflict reso
71b0: 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d  lution algorithm
71c0: 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65   can be specifie
71d0: 64 20 69 6e 20 74 68 72 65 65 20 70 6c 61 63 65  d in three place
71e0: 73 2c 0a 69 6e 20 6f 72 64 65 72 20 66 72 6f 6d  s,.in order from
71f0: 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 68 65   lowest to highe
7200: 73 74 20 70 72 65 63 65 64 65 6e 63 65 3a 0a 3c  st precedence:.<
7210: 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70  /p>..<ol>.<li><p
7220: 3e 0a 4f 6e 20 61 20 42 45 47 49 4e 20 54 52 41  >.On a BEGIN TRA
7230: 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e 64  NSACTION command
7240: 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69  ..</p></li>..<li
7250: 3e 3c 70 3e 0a 4f 6e 20 69 6e 64 69 76 69 64 75  ><p>.On individu
7260: 61 6c 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 77  al constraints w
7270: 69 74 68 69 6e 20 61 20 43 52 45 41 54 45 20 54  ithin a CREATE T
7280: 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49  ABLE or CREATE I
7290: 4e 44 45 58 0a 73 74 61 74 65 6d 65 6e 74 2e 0a  NDEX.statement..
72a0: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c  </p></li>..<li><
72b0: 70 3e 0a 49 6e 20 74 68 65 20 4f 52 20 63 6c 61  p>.In the OR cla
72c0: 75 73 65 20 6f 66 20 61 20 43 4f 50 59 2c 20 49  use of a COPY, I
72d0: 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45  NSERT, or UPDATE
72e0: 20 63 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70 3e 3c 2f   command..</p></
72f0: 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54 68  li>.</ol>..<p>Th
7300: 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63  e algorithm spec
7310: 69 66 69 65 64 20 69 6e 20 74 68 65 20 4f 52 20  ified in the OR 
7320: 63 6c 61 75 73 65 20 6f 66 20 61 20 43 4f 50 59  clause of a COPY
7330: 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44  , INSERT, or UPD
7340: 41 54 45 0a 6f 76 65 72 72 69 64 65 73 20 61 6e  ATE.overrides an
7350: 79 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63  y algorithm spec
7360: 69 66 69 65 64 20 62 79 20 61 20 43 52 45 41 54  ified by a CREAT
7370: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
7380: 45 20 49 4e 44 45 58 2e 0a 54 68 65 20 61 6c 67  E INDEX..The alg
7390: 6f 72 69 74 68 6d 20 73 70 65 63 69 66 69 65 64  orithm specified
73a0: 20 77 69 74 68 69 6e 20 61 20 43 52 45 41 54 45   within a CREATE
73b0: 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45   TABLE or CREATE
73c0: 20 49 4e 44 45 58 20 77 69 6c 6c 2c 20 69 6e 20   INDEX will, in 
73d0: 74 75 72 6e 2c 0a 6f 76 65 72 72 69 64 65 20 74  turn,.override t
73e0: 68 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65  he algorithm spe
73f0: 63 69 66 69 65 64 20 62 79 20 61 20 42 45 47 49  cified by a BEGI
7400: 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63 6f  N TRANSACTION co
7410: 6d 6d 61 6e 64 2e 0a 49 66 20 6e 6f 20 61 6c 67  mmand..If no alg
7420: 6f 72 69 74 68 6d 20 69 73 20 73 70 65 63 69 66  orithm is specif
7430: 69 65 64 20 61 6e 79 77 68 65 72 65 2c 20 74 68  ied anywhere, th
7440: 65 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68  e ABORT algorith
7450: 6d 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 0a  m is used.</p>..
7460: 7d 0a 23 20 3c 70 3e 46 6f 72 20 61 64 64 69 74  }.# <p>For addit
7470: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
7480: 6e 2c 20 73 65 65 20 0a 23 20 3c 61 20 68 72 65  n, see .# <a hre
7490: 66 3d 22 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c  f="conflict.html
74a0: 22 3e 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c 3c  ">conflict.html<
74b0: 2f 61 3e 2e 3c 2f 70 3e 0a 0a 0a 53 65 63 74 69  /a>.</p>...Secti
74c0: 6f 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d 61  on PRAGMA pragma
74d0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
74e0: 61 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47 4d  atement} {.PRAGM
74f0: 41 20 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c 75  A <name> = <valu
7500: 65 3e 20 7c 0a 50 52 41 47 4d 41 20 3c 66 75 6e  e> |.PRAGMA <fun
7510: 63 74 69 6f 6e 3e 28 3c 61 72 67 3e 29 0a 7d 0a  ction>(<arg>).}.
7520: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 50  .puts {.<p>The P
7530: 52 41 47 4d 41 20 63 6f 6d 6d 61 6e 64 20 69 73  RAGMA command is
7540: 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20   used to modify 
7550: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66  the operation of
7560: 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72   the SQLite libr
7570: 61 72 79 2e 0a 54 68 65 20 70 72 61 67 6d 61 20  ary..The pragma 
7580: 63 6f 6d 6d 61 6e 64 20 69 73 20 65 78 70 65 72  command is exper
7590: 69 6d 65 6e 74 61 6c 20 61 6e 64 20 73 70 65 63  imental and spec
75a0: 69 66 69 63 20 70 72 61 67 6d 61 20 73 74 61 74  ific pragma stat
75b0: 65 6d 65 6e 74 73 20 6d 61 79 0a 72 65 6d 6f 76  ements may.remov
75c0: 65 64 20 6f 72 20 61 64 64 65 64 20 69 6e 20 66  ed or added in f
75d0: 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 20 6f  uture releases o
75e0: 66 20 53 51 4c 69 74 65 2e 20 20 55 73 65 20 74  f SQLite.  Use t
75f0: 68 69 73 20 63 6f 6d 6d 61 6e 64 0a 77 69 74 68  his command.with
7600: 20 63 61 75 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c   caution.</p>..<
7610: 70 3e 54 68 65 20 63 75 72 72 65 6e 74 20 69 6d  p>The current im
7620: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 75 70  plementation sup
7630: 70 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f 77  ports the follow
7640: 69 6e 67 20 70 72 61 67 6d 61 73 3a 3c 2f 70 3e  ing pragmas:</p>
7650: 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62  ..<ul>.<li><p><b
7660: 3e 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69  >PRAGMA cache_si
7670: 7a 65 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e 50  ze;.       <br>P
7680: 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69 7a 65  RAGMA cache_size
7690: 20 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d 62 65 72   = </b><i>Number
76a0: 2d 6f 66 2d 70 61 67 65 73 3c 2f 69 3e 3c 62 3e  -of-pages</i><b>
76b0: 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70  ;</b></p>.    <p
76c0: 3e 51 75 65 72 79 20 6f 72 20 63 68 61 6e 67 65  >Query or change
76d0: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d   the maximum num
76e0: 62 65 72 20 6f 66 20 64 61 74 61 62 61 73 65 20  ber of database 
76f0: 64 69 73 6b 20 70 61 67 65 73 20 74 68 61 74 20  disk pages that 
7700: 53 51 4c 69 74 65 0a 20 20 20 20 77 69 6c 6c 20  SQLite.    will 
7710: 68 6f 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 61  hold in memory a
7720: 74 20 6f 6e 63 65 2e 20 20 45 61 63 68 20 70 61  t once.  Each pa
7730: 67 65 20 75 73 65 73 20 61 62 6f 75 74 20 31 2e  ge uses about 1.
7740: 35 4b 20 6f 66 20 6d 65 6d 6f 72 79 2e 0a 20 20  5K of memory..  
7750: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 63 61    The default ca
7760: 63 68 65 20 73 69 7a 65 20 69 73 20 32 30 30 30  che size is 2000
7770: 2e 20 20 49 66 20 79 6f 75 20 61 72 65 20 64 6f  .  If you are do
7780: 69 6e 67 20 55 50 44 41 54 45 73 20 6f 72 20 44  ing UPDATEs or D
7790: 45 4c 45 54 45 73 0a 20 20 20 20 74 68 61 74 20  ELETEs.    that 
77a0: 63 68 61 6e 67 65 20 6d 61 6e 79 20 72 6f 77 73  change many rows
77b0: 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 61   of a database a
77c0: 6e 64 20 79 6f 75 20 64 6f 20 6e 6f 74 20 6d 69  nd you do not mi
77d0: 6e 64 20 69 66 20 53 51 4c 69 74 65 0a 20 20 20  nd if SQLite.   
77e0: 20 75 73 65 73 20 6d 6f 72 65 20 6d 65 6d 6f 72   uses more memor
77f0: 79 2c 20 79 6f 75 20 63 61 6e 20 69 6e 63 72 65  y, you can incre
7800: 61 73 65 20 74 68 65 20 63 61 63 68 65 20 73 69  ase the cache si
7810: 7a 65 20 66 6f 72 20 61 20 70 6f 73 73 69 62 6c  ze for a possibl
7820: 65 20 73 70 65 65 64 0a 20 20 20 20 69 6d 70 72  e speed.    impr
7830: 6f 76 65 6d 65 6e 74 2e 3c 2f 70 3e 0a 20 20 20  ovement.</p>.   
7840: 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 63 68 61   <p>When you cha
7850: 6e 67 65 20 74 68 65 20 63 61 63 68 65 20 73 69  nge the cache si
7860: 7a 65 20 75 73 69 6e 67 20 74 68 65 20 63 61 63  ze using the cac
7870: 68 65 5f 73 69 7a 65 20 70 72 61 67 6d 61 2c 20  he_size pragma, 
7880: 74 68 65 0a 20 20 20 20 63 68 61 6e 67 65 20 6f  the.    change o
7890: 6e 6c 79 20 65 6e 64 75 72 65 73 20 66 6f 72 20  nly endures for 
78a0: 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 73 73  the current sess
78b0: 69 6f 6e 2e 20 20 54 68 65 20 63 61 63 68 65 20  ion.  The cache 
78c0: 73 69 7a 65 20 72 65 76 65 72 74 73 0a 20 20 20  size reverts.   
78d0: 20 74 6f 20 74 68 65 20 64 65 66 61 75 6c 74 20   to the default 
78e0: 76 61 6c 75 65 20 77 68 65 6e 20 74 68 65 20 64  value when the d
78f0: 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65  atabase is close
7900: 64 20 61 6e 64 20 72 65 6f 70 65 6e 65 64 2e 20  d and reopened. 
7910: 20 55 73 65 0a 20 20 20 20 74 68 65 20 3c 62 3e   Use.    the <b>
7920: 64 65 66 61 75 6c 74 5f 63 61 63 68 65 5f 73 69  default_cache_si
7930: 7a 65 3c 2f 62 3e 20 70 72 61 67 6d 61 20 74 6f  ze</b> pragma to
7940: 20 63 68 65 63 6b 20 74 68 65 20 63 61 63 68 65   check the cache
7950: 20 73 69 7a 65 20 70 65 72 6d 61 6e 65 6e 74 6c   size permanentl
7960: 79 0a 20 20 20 20 3c 2f 70 3e 3c 2f 6c 69 3e 0a  y.    </p></li>.
7970: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d  .<li><p><b>PRAGM
7980: 41 20 63 6f 75 6e 74 5f 63 68 61 6e 67 65 73 20  A count_changes 
7990: 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72  = ON;.       <br
79a0: 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f 63 68  >PRAGMA count_ch
79b0: 61 6e 67 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e  anges = OFF;</b>
79c0: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 57 68 65 6e  </p>.    <p>When
79d0: 20 6f 6e 2c 20 74 68 65 20 43 4f 55 4e 54 5f 43   on, the COUNT_C
79e0: 48 41 4e 47 45 53 20 70 72 61 67 6d 61 20 63 61  HANGES pragma ca
79f0: 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62 61 63  uses the callbac
7a00: 6b 20 66 75 6e 63 74 69 6f 6e 20 74 6f 0a 20 20  k function to.  
7a10: 20 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f 6e 63    be invoked onc
7a20: 65 20 66 6f 72 20 65 61 63 68 20 44 45 4c 45 54  e for each DELET
7a30: 45 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50  E, INSERT, or UP
7a40: 44 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 2e 20  DATE operation. 
7a50: 20 54 68 65 0a 20 20 20 20 61 72 67 75 6d 65 6e   The.    argumen
7a60: 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20  t is the number 
7a70: 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77 65 72  of rows that wer
7a80: 65 20 63 68 61 6e 67 65 64 2e 3c 2f 70 3e 0a 0a  e changed.</p>..
7a90: 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41  <li><p><b>PRAGMA
7aa0: 20 64 65 66 61 75 6c 74 5f 63 61 63 68 65 5f 73   default_cache_s
7ab0: 69 7a 65 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e  ize;.       <br>
7ac0: 50 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f 63  PRAGMA default_c
7ad0: 61 63 68 65 5f 73 69 7a 65 20 3d 20 3c 2f 62 3e  ache_size = </b>
7ae0: 3c 69 3e 4e 75 6d 62 65 72 2d 6f 66 2d 70 61 67  <i>Number-of-pag
7af0: 65 73 3c 2f 69 3e 3c 62 3e 3b 3c 2f 62 3e 3c 2f  es</i><b>;</b></
7b00: 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72 79 20  p>.    <p>Query 
7b10: 6f 72 20 63 68 61 6e 67 65 20 74 68 65 20 6d 61  or change the ma
7b20: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20  ximum number of 
7b30: 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 70 61  database disk pa
7b40: 67 65 73 20 74 68 61 74 20 53 51 4c 69 74 65 0a  ges that SQLite.
7b50: 20 20 20 20 77 69 6c 6c 20 68 6f 6c 64 20 69 6e      will hold in
7b60: 20 6d 65 6d 6f 72 79 20 61 74 20 6f 6e 63 65 2e   memory at once.
7b70: 20 20 45 61 63 68 20 70 61 67 65 20 75 73 65 73    Each page uses
7b80: 20 61 62 6f 75 74 20 31 2e 35 4b 20 6f 66 20 6d   about 1.5K of m
7b90: 65 6d 6f 72 79 2e 0a 20 20 20 20 54 68 69 73 20  emory..    This 
7ba0: 70 72 61 67 6d 61 20 77 6f 72 6b 73 20 6c 69 6b  pragma works lik
7bb0: 65 20 74 68 65 20 3c 62 3e 63 61 63 68 65 5f 73  e the <b>cache_s
7bc0: 69 7a 65 3c 2f 62 3e 20 70 72 61 67 6d 61 20 77  ize</b> pragma w
7bd0: 69 74 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e  ith the addition
7be0: 0a 20 20 20 20 66 65 61 74 75 72 65 20 74 68 61  .    feature tha
7bf0: 74 20 69 74 20 63 68 61 6e 67 65 73 20 74 68 65  t it changes the
7c00: 20 63 61 63 68 65 20 73 69 7a 65 20 70 65 72 73   cache size pers
7c10: 69 73 74 65 6e 74 6c 79 2e 20 20 57 69 74 68 20  istently.  With 
7c20: 74 68 69 73 20 70 72 61 67 6d 61 2c 0a 20 20 20  this pragma,.   
7c30: 20 79 6f 75 20 63 61 6e 20 73 65 74 20 74 68 65   you can set the
7c40: 20 63 61 63 68 65 20 73 69 7a 65 20 6f 6e 63 65   cache size once
7c50: 20 61 6e 64 20 74 68 61 74 20 73 65 74 74 69 6e   and that settin
7c60: 67 20 69 73 20 72 65 74 61 69 6e 65 64 20 61 6e  g is retained an
7c70: 64 20 72 65 75 73 65 64 0a 20 20 20 20 65 76 65  d reused.    eve
7c80: 72 79 74 69 6d 65 20 79 6f 75 20 72 65 6f 70 65  rytime you reope
7c90: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 3c  n the database.<
7ca0: 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70  /p></li>..<li><p
7cb0: 3e 3c 62 3e 50 52 41 47 4d 41 20 64 65 66 61 75  ><b>PRAGMA defau
7cc0: 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f 75 73 3b 0a  lt_synchronous;.
7cd0: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
7ce0: 41 20 64 65 66 61 75 6c 74 5f 73 79 6e 63 68 72  A default_synchr
7cf0: 6f 6e 6f 75 73 20 3d 20 4f 4e 3b 0a 20 20 20 20  onous = ON;.    
7d00: 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 64 65     <br>PRAGMA de
7d10: 66 61 75 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f 75  fault_synchronou
7d20: 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e  s = OFF;</b></p>
7d30: 0a 20 20 20 20 3c 70 3e 51 75 65 72 79 20 6f 72  .    <p>Query or
7d40: 20 63 68 61 6e 67 65 20 74 68 65 20 73 65 74 74   change the sett
7d50: 69 6e 67 20 6f 66 20 74 68 65 20 22 73 79 6e 63  ing of the "sync
7d60: 68 72 6f 6e 6f 75 73 22 20 66 6c 61 67 20 69 6e  hronous" flag in
7d70: 0a 20 20 20 20 74 68 65 20 64 61 74 61 62 61 73  .    the databas
7d80: 65 2e 20 20 57 68 65 6e 20 73 79 6e 63 68 72 6f  e.  When synchro
7d90: 6e 6f 75 73 20 69 73 20 6f 6e 20 28 74 68 65 20  nous is on (the 
7da0: 64 65 66 61 75 6c 74 29 2c 20 74 68 65 20 53 51  default), the SQ
7db0: 4c 69 74 65 20 64 61 74 61 62 61 73 65 0a 20 20  Lite database.  
7dc0: 20 20 65 6e 67 69 6e 65 20 77 69 6c 6c 20 70 61    engine will pa
7dd0: 75 73 65 20 61 74 20 63 72 69 74 69 63 61 6c 20  use at critical 
7de0: 6d 6f 6d 65 6e 74 73 20 74 6f 20 6d 61 6b 65 20  moments to make 
7df0: 73 75 72 65 20 74 68 61 74 20 64 61 74 61 20 68  sure that data h
7e00: 61 73 20 61 63 74 75 61 6c 6c 79 0a 20 20 20 20  as actually.    
7e10: 62 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68  be written to th
7e20: 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 2e 20  e disk surface. 
7e30: 20 28 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73   (In other words
7e40: 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68 65  , it invokes the
7e50: 0a 20 20 20 20 65 71 75 69 76 61 6c 65 6e 74 20  .    equivalent 
7e60: 6f 66 20 74 68 65 20 3c 62 3e 66 73 79 6e 63 28  of the <b>fsync(
7e70: 29 3c 2f 62 3e 20 73 79 73 74 65 6d 20 63 61 6c  )</b> system cal
7e80: 6c 2e 29 20 20 49 6e 20 73 79 6e 63 68 72 6f 6e  l.)  In synchron
7e90: 6f 75 73 20 6d 6f 64 65 2c 0a 20 20 20 20 61 6e  ous mode,.    an
7ea0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65   SQLite database
7eb0: 20 73 68 6f 75 6c 64 20 62 65 20 66 75 6c 6c 79   should be fully
7ec0: 20 72 65 63 6f 76 65 72 61 62 6c 65 20 65 76 65   recoverable eve
7ed0: 6e 20 69 66 20 74 68 65 20 6f 70 65 72 61 74 69  n if the operati
7ee0: 6e 67 0a 20 20 20 20 73 79 73 74 65 6d 20 63 72  ng.    system cr
7ef0: 61 73 68 65 73 20 6f 72 20 70 6f 77 65 72 20 69  ashes or power i
7f00: 73 20 69 6e 74 65 72 72 75 70 74 65 64 20 75 6e  s interrupted un
7f10: 65 78 70 65 63 74 65 64 6c 79 2e 20 20 54 68 65  expectedly.  The
7f20: 20 70 65 6e 61 6c 74 79 20 66 6f 72 0a 20 20 20   penalty for.   
7f30: 20 74 68 69 73 20 61 73 73 75 72 61 6e 63 65 20   this assurance 
7f40: 69 73 20 74 68 61 74 20 73 6f 6d 65 20 64 61 74  is that some dat
7f50: 61 62 61 73 65 20 6f 70 65 72 61 74 69 6f 6e 73  abase operations
7f60: 20 74 61 6b 65 20 6c 6f 6e 67 65 72 20 62 65 63   take longer bec
7f70: 61 75 73 65 20 74 68 65 0a 20 20 20 20 65 6e 67  ause the.    eng
7f80: 69 6e 65 20 68 61 73 20 74 6f 20 77 61 69 74 20  ine has to wait 
7f90: 6f 6e 20 74 68 65 20 28 72 65 6c 61 74 69 76 65  on the (relative
7fa0: 6c 79 20 73 6c 6f 77 29 20 64 69 73 6b 20 64 72  ly slow) disk dr
7fb0: 69 76 65 2e 20 20 54 68 65 20 61 6c 74 65 72 6e  ive.  The altern
7fc0: 61 74 69 76 65 0a 20 20 20 20 69 73 20 74 6f 20  ative.    is to 
7fd0: 74 75 72 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 73  turn synchronous
7fe0: 20 6f 66 66 2e 20 20 57 69 74 68 20 73 79 6e 63   off.  With sync
7ff0: 68 72 6f 6e 6f 75 73 20 6f 66 66 2c 20 53 51 4c  hronous off, SQL
8000: 69 74 65 20 63 6f 6e 74 69 6e 75 65 73 0a 20 20  ite continues.  
8010: 20 20 70 72 6f 63 65 73 73 69 6e 67 20 61 73 20    processing as 
8020: 73 6f 6f 6e 20 61 73 20 69 74 20 68 61 73 20 68  soon as it has h
8030: 61 6e 64 65 64 20 64 61 74 61 20 6f 66 66 20 74  anded data off t
8040: 6f 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20  o the operating 
8050: 73 79 73 74 65 6d 2e 0a 20 20 20 20 49 66 20 74  system..    If t
8060: 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 72  he application r
8070: 75 6e 6e 69 6e 67 20 53 51 4c 69 74 65 20 63 72  unning SQLite cr
8080: 61 73 68 65 73 2c 20 74 68 65 20 64 61 74 61 20  ashes, the data 
8090: 77 69 6c 6c 20 62 65 20 73 61 66 65 2c 20 62 75  will be safe, bu
80a0: 74 0a 20 20 20 20 74 68 65 20 64 61 74 61 62 61  t.    the databa
80b0: 73 65 20 63 6f 75 6c 64 20 28 69 6e 20 74 68 65  se could (in the
80c0: 6f 72 79 29 20 62 65 63 6f 6d 65 20 63 6f 72 72  ory) become corr
80d0: 75 70 74 65 64 20 69 66 20 74 68 65 20 6f 70 65  upted if the ope
80e0: 72 61 74 69 6e 67 20 73 79 73 74 65 6d 0a 20 20  rating system.  
80f0: 20 20 63 72 61 73 68 65 73 20 6f 72 20 74 68 65    crashes or the
8100: 20 63 6f 6d 70 75 74 65 72 20 73 75 64 64 65 6e   computer sudden
8110: 6c 79 20 6c 6f 73 65 73 20 70 6f 77 65 72 2e 20  ly loses power. 
8120: 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61   On the other ha
8130: 6e 64 2c 20 73 6f 6d 65 0a 20 20 20 20 6f 70 65  nd, some.    ope
8140: 72 61 74 69 6f 6e 73 20 61 72 65 20 61 73 20 6d  rations are as m
8150: 75 63 68 20 61 73 20 35 30 20 6f 72 20 6d 6f 72  uch as 50 or mor
8160: 65 20 74 69 6d 65 73 20 66 61 73 74 65 72 20 77  e times faster w
8170: 69 74 68 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20  ith synchronous 
8180: 6f 66 66 2e 0a 20 20 20 20 3c 2f 70 3e 0a 20 20  off..    </p>.  
8190: 20 20 3c 70 3e 54 68 69 73 20 70 72 61 67 6d 61    <p>This pragma
81a0: 20 63 68 61 6e 67 65 73 20 74 68 65 20 73 79 6e   changes the syn
81b0: 63 68 72 6f 6e 6f 75 73 20 6d 6f 64 65 20 70 65  chronous mode pe
81c0: 72 73 69 73 74 65 6e 74 6c 79 2e 20 20 4f 6e 63  rsistently.  Onc
81d0: 65 20 63 68 61 6e 67 65 64 2c 0a 20 20 20 20 74  e changed,.    t
81e0: 68 65 20 6d 6f 64 65 20 73 74 61 79 73 20 61 73  he mode stays as
81f0: 20 73 65 74 20 65 76 65 6e 20 69 66 20 74 68 65   set even if the
8200: 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f   database is clo
8210: 73 65 64 20 61 6e 64 20 72 65 6f 70 65 6e 65 64  sed and reopened
8220: 2e 20 20 54 68 65 0a 20 20 20 20 3c 62 3e 73 79  .  The.    <b>sy
8230: 6e 63 68 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70 72  nchronous</b> pr
8240: 61 67 6d 61 20 64 6f 65 73 20 74 68 65 20 73 61  agma does the sa
8250: 6d 65 20 74 68 69 6e 67 20 62 75 74 20 6f 6e 6c  me thing but onl
8260: 79 20 61 70 70 6c 69 65 73 20 74 68 65 20 73 65  y applies the se
8270: 74 74 69 6e 67 0a 20 20 20 20 74 6f 20 74 68 65  tting.    to the
8280: 20 63 75 72 72 65 6e 74 20 73 65 73 73 69 6f 6e   current session
8290: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
82a0: 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65  >PRAGMA empty_re
82b0: 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d  sult_callbacks =
82c0: 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e   ON;.       <br>
82d0: 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65 73  PRAGMA empty_res
82e0: 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d 20  ult_callbacks = 
82f0: 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  OFF;</b></p>.   
8300: 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68 65   <p>When on, the
8310: 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41   EMPTY_RESULT_CA
8320: 4c 4c 42 41 43 4b 53 20 70 72 61 67 6d 61 20 63  LLBACKS pragma c
8330: 61 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62 61  auses the callba
8340: 63 6b 0a 20 20 20 20 66 75 6e 63 74 69 6f 6e 20  ck.    function 
8350: 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f 6e  to be invoked on
8360: 63 65 20 66 6f 72 20 65 61 63 68 20 71 75 65 72  ce for each quer
8370: 79 20 74 68 61 74 20 68 61 73 20 61 6e 20 65 6d  y that has an em
8380: 70 74 79 20 72 65 73 75 6c 74 0a 20 20 20 20 73  pty result.    s
8390: 65 74 2e 20 20 54 68 65 20 74 68 69 72 64 20 22  et.  The third "
83a0: 3c 62 3e 61 72 67 76 3c 2f 62 3e 22 20 70 61 72  <b>argv</b>" par
83b0: 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20 63 61  ameter to the ca
83c0: 6c 6c 62 61 63 6b 20 69 73 20 73 65 74 20 74 6f  llback is set to
83d0: 20 4e 55 4c 4c 0a 20 20 20 20 62 65 63 61 75 73   NULL.    becaus
83e0: 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 61  e there is no da
83f0: 74 61 20 74 6f 20 72 65 70 6f 72 74 2e 20 20 42  ta to report.  B
8400: 75 74 20 74 68 65 20 73 65 63 6f 6e 64 20 22 3c  ut the second "<
8410: 62 3e 61 72 67 63 3c 2f 62 3e 22 20 61 6e 64 0a  b>argc</b>" and.
8420: 20 20 20 20 66 6f 75 72 74 68 20 22 3c 62 3e 63      fourth "<b>c
8430: 6f 6c 75 6d 6e 4e 61 6d 65 73 3c 2f 62 3e 22 20  olumnNames</b>" 
8440: 70 61 72 61 6d 65 74 65 72 73 20 61 72 65 20 76  parameters are v
8450: 61 6c 69 64 20 61 6e 64 20 63 61 6e 20 62 65 20  alid and can be 
8460: 75 73 65 64 20 74 6f 0a 20 20 20 20 64 65 74 65  used to.    dete
8470: 72 6d 69 6e 65 20 74 68 65 20 6e 75 6d 62 65 72  rmine the number
8480: 20 61 6e 64 20 6e 61 6d 65 73 20 6f 66 20 74 68   and names of th
8490: 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 77  e columns that w
84a0: 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 69  ould have been i
84b0: 6e 0a 20 20 20 20 74 68 65 20 72 65 73 75 6c 74  n.    the result
84c0: 20 73 65 74 20 68 61 64 20 74 68 65 20 73 65 74   set had the set
84d0: 20 6e 6f 74 20 62 65 65 6e 20 65 6d 70 74 79 2e   not been empty.
84e0: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
84f0: 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f 6c 75  PRAGMA full_colu
8500: 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 4e 3b 0a 20  mn_names = ON;. 
8510: 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41        <br>PRAGMA
8520: 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d   full_column_nam
8530: 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70  es = OFF;</b></p
8540: 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f 6c  >.    <p>The col
8550: 75 6d 6e 20 6e 61 6d 65 73 20 72 65 70 6f 72 74  umn names report
8560: 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65 20  ed in an SQLite 
8570: 63 61 6c 6c 62 61 63 6b 20 61 72 65 20 6e 6f 72  callback are nor
8580: 6d 61 6c 6c 79 20 6a 75 73 74 0a 20 20 20 20 74  mally just.    t
8590: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63  he name of the c
85a0: 6f 6c 75 6d 6e 20 69 74 73 65 6c 66 2c 20 65 78  olumn itself, ex
85b0: 63 65 70 74 20 66 6f 72 20 6a 6f 69 6e 73 20 77  cept for joins w
85c0: 68 65 6e 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d  hen "TABLE.COLUM
85d0: 4e 22 0a 20 20 20 20 69 73 20 75 73 65 64 2e 20  N".    is used. 
85e0: 20 42 75 74 20 77 68 65 6e 20 66 75 6c 6c 5f 63   But when full_c
85f0: 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 69 73 20 74  olumn_names is t
8600: 75 72 6e 65 64 20 6f 6e 2c 20 63 6f 6c 75 6d 6e  urned on, column
8610: 20 6e 61 6d 65 73 20 61 72 65 0a 20 20 20 20 61   names are.    a
8620: 6c 77 61 79 73 20 72 65 70 6f 72 74 65 64 20 61  lways reported a
8630: 73 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 22  s "TABLE.COLUMN"
8640: 20 65 76 65 6e 20 66 6f 72 20 73 69 6d 70 6c 65   even for simple
8650: 20 71 75 65 72 69 65 73 2e 3c 2f 70 3e 3c 2f 6c   queries.</p></l
8660: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52  i>..<li><p><b>PR
8670: 41 47 4d 41 20 69 6e 64 65 78 5f 69 6e 66 6f 28  AGMA index_info(
8680: 3c 2f 62 3e 3c 69 3e 69 6e 64 65 78 2d 6e 61 6d  </b><i>index-nam
8690: 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f  e</i><b>);</b></
86a0: 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61  p>.    <p>For ea
86b0: 63 68 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74  ch column that t
86c0: 68 65 20 6e 61 6d 65 64 20 69 6e 64 65 78 20 72  he named index r
86d0: 65 66 65 72 65 6e 63 65 73 2c 20 69 6e 76 6f 6b  eferences, invok
86e0: 65 20 74 68 65 20 0a 20 20 20 20 63 61 6c 6c 62  e the .    callb
86f0: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20  ack function.   
8700: 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72   once with infor
8710: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61  mation about tha
8720: 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64  t column, includ
8730: 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e  ing the column n
8740: 61 6d 65 2c 0a 20 20 20 20 61 6e 64 20 74 68 65  ame,.    and the
8750: 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 2e 3c   column number.<
8760: 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50  /p>..<li><p><b>P
8770: 52 41 47 4d 41 20 69 6e 64 65 78 5f 6c 69 73 74  RAGMA index_list
8780: 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61  (</b><i>table-na
8790: 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c  me</i><b>);</b><
87a0: 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65  /p>.    <p>For e
87b0: 61 63 68 20 69 6e 64 65 78 20 6f 6e 20 74 68 65  ach index on the
87c0: 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e   named table, in
87d0: 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63  voke the callbac
87e0: 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f  k function.    o
87f0: 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61  nce with informa
8800: 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20  tion about that 
8810: 69 6e 64 65 78 2e 20 20 41 72 67 75 6d 65 6e 74  index.  Argument
8820: 73 20 69 6e 63 6c 75 64 65 20 74 68 65 0a 20 20  s include the.  
8830: 20 20 69 6e 64 65 78 20 6e 61 6d 65 20 61 6e 64    index name and
8840: 20 61 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 63   a flag to indic
8850: 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e  ate whether or n
8860: 6f 74 20 74 68 65 20 69 6e 64 65 78 20 6d 75 73  ot the index mus
8870: 74 20 62 65 0a 20 20 20 20 75 6e 69 71 75 65 2e  t be.    unique.
8880: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
8890: 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72  PRAGMA parser_tr
88a0: 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41  ace = ON;<br>PRA
88b0: 47 4d 41 20 70 61 72 73 65 72 5f 74 72 61 63 65  GMA parser_trace
88c0: 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a   = OFF;</b></p>.
88d0: 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61 63      <p>Turn trac
88e0: 69 6e 67 20 6f 66 20 74 68 65 20 53 51 4c 20 70  ing of the SQL p
88f0: 61 72 73 65 72 20 69 6e 73 69 64 65 20 6f 66 20  arser inside of 
8900: 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c  the.    SQLite l
8910: 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66  ibrary on and of
8920: 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  f.  This is used
8930: 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 0a   for debugging..
8940: 20 20 20 20 54 68 69 73 20 6f 6e 6c 79 20 77 6f      This only wo
8950: 72 6b 73 20 69 66 20 74 68 65 20 6c 69 62 72 61  rks if the libra
8960: 72 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77  ry is compiled w
8970: 69 74 68 6f 75 74 20 74 68 65 20 4e 44 45 42 55  ithout the NDEBU
8980: 47 20 6d 61 63 72 6f 2e 0a 20 20 20 20 3c 2f 70  G macro..    </p
8990: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c  ></li>..<li><p><
89a0: 62 3e 50 52 41 47 4d 41 20 69 6e 74 65 67 72 69  b>PRAGMA integri
89b0: 74 79 5f 63 68 65 63 6b 3b 3c 2f 62 3e 3c 2f 70  ty_check;</b></p
89c0: 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f 6d  >.    <p>The com
89d0: 6d 61 6e 64 20 64 6f 65 73 20 61 6e 20 69 6e 74  mand does an int
89e0: 65 67 72 69 74 79 20 63 68 65 63 6b 20 6f 66 20  egrity check of 
89f0: 74 68 65 20 65 6e 74 69 72 65 20 64 61 74 61 62  the entire datab
8a00: 61 73 65 2e 20 20 49 74 0a 20 20 20 20 6c 6f 6f  ase.  It.    loo
8a10: 6b 73 20 66 6f 72 20 6f 75 74 2d 6f 66 2d 6f 72  ks for out-of-or
8a20: 64 65 72 20 72 65 63 6f 72 64 73 2c 20 6d 69 73  der records, mis
8a30: 73 69 6e 67 20 70 61 67 65 73 2c 20 61 6e 64 20  sing pages, and 
8a40: 6d 61 6c 66 6f 72 6d 65 64 20 72 65 63 6f 72 64  malformed record
8a50: 73 2e 0a 20 20 20 20 49 66 20 61 6e 79 20 70 72  s..    If any pr
8a60: 6f 62 6c 65 6d 73 20 61 72 65 20 66 6f 75 6e 64  oblems are found
8a70: 2c 20 74 68 65 6e 20 61 20 73 69 6e 67 6c 65 20  , then a single 
8a80: 73 74 72 69 6e 67 20 69 73 20 72 65 74 75 72 6e  string is return
8a90: 65 64 20 77 68 69 63 68 20 69 73 0a 20 20 20 20  ed which is.    
8aa0: 61 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  a description of
8ab0: 20 61 6c 6c 20 70 72 6f 62 6c 65 6d 73 2e 20 20   all problems.  
8ac0: 49 66 20 65 76 65 72 79 74 68 69 6e 67 20 69 73  If everything is
8ad0: 20 69 6e 20 6f 72 64 65 72 2c 20 22 6f 6b 22 20   in order, "ok" 
8ae0: 69 73 0a 20 20 20 20 72 65 74 75 72 6e 65 64 2e  is.    returned.
8af0: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
8b00: 50 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f  PRAGMA synchrono
8b10: 75 73 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e 50  us;.       <br>P
8b20: 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75  RAGMA synchronou
8b30: 73 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c  s = ON;.       <
8b40: 62 72 3e 50 52 41 47 4d 41 20 73 79 6e 63 68 72  br>PRAGMA synchr
8b50: 6f 6e 6f 75 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e  onous = OFF;</b>
8b60: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72  </p>.    <p>Quer
8b70: 79 20 6f 72 20 63 68 61 6e 67 65 20 74 68 65 20  y or change the 
8b80: 73 65 74 74 69 6e 67 20 6f 66 20 74 68 65 20 22  setting of the "
8b90: 73 79 6e 63 68 72 6f 6e 6f 75 73 22 20 66 6c 61  synchronous" fla
8ba0: 67 20 69 6e 0a 20 20 20 20 74 68 65 20 64 61 74  g in.    the dat
8bb0: 61 62 61 73 65 20 66 6f 72 20 74 68 65 20 64 75  abase for the du
8bc0: 72 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63 75  ration of the cu
8bd0: 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 63  rrent database c
8be0: 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 54 68 65 20  onnect..    The 
8bf0: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 66 6c 61 67  synchronous flag
8c00: 20 72 65 76 65 72 74 73 20 74 6f 20 69 74 73 20   reverts to its 
8c10: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 77 68  default value wh
8c20: 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  en the database.
8c30: 20 20 20 20 69 73 20 63 6c 6f 73 65 64 20 61 6e      is closed an
8c40: 64 20 72 65 6f 70 65 6e 65 64 2e 20 20 46 6f 72  d reopened.  For
8c50: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   additional info
8c60: 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 73  rmation on the s
8c70: 79 6e 63 68 72 6f 6e 6f 75 73 0a 20 20 20 20 66  ynchronous.    f
8c80: 6c 61 67 2c 20 73 65 65 20 74 68 65 20 64 65 73  lag, see the des
8c90: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20  cription of the 
8ca0: 3c 62 3e 64 65 66 61 75 6c 74 5f 73 79 6e 63 68  <b>default_synch
8cb0: 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70 72 61 67 6d  ronous</b> pragm
8cc0: 61 2e 3c 2f 70 3e 0a 20 20 20 20 3c 2f 6c 69 3e  a.</p>.    </li>
8cd0: 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47  ..<li><p><b>PRAG
8ce0: 4d 41 20 74 61 62 6c 65 5f 69 6e 66 6f 28 3c 2f  MA table_info(</
8cf0: 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61 6d 65 3c  b><i>table-name<
8d00: 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e  /i><b>);</b></p>
8d10: 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61 63 68  .    <p>For each
8d20: 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 6e   column in the n
8d30: 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e 76 6f  amed table, invo
8d40: 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20  ke the callback 
8d50: 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f 6e 63  function.    onc
8d60: 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69  e with informati
8d70: 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20 63 6f  on about that co
8d80: 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20  lumn, including 
8d90: 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 2c  the column name,
8da0: 0a 20 20 20 20 64 61 74 61 20 74 79 70 65 2c 20  .    data type, 
8db0: 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74  whether or not t
8dc0: 68 65 20 63 6f 6c 75 6d 6e 20 63 61 6e 20 62 65  he column can be
8dd0: 20 4e 55 4c 4c 2c 20 61 6e 64 20 74 68 65 20 64   NULL, and the d
8de0: 65 66 61 75 6c 74 0a 20 20 20 20 76 61 6c 75 65  efault.    value
8df0: 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 2e   for the column.
8e00: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
8e10: 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61 63  PRAGMA vdbe_trac
8e20: 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41 47 4d  e = ON;<br>PRAGM
8e30: 41 20 76 64 62 65 5f 74 72 61 63 65 20 3d 20 4f  A vdbe_trace = O
8e40: 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20  FF;</b></p>.    
8e50: 3c 70 3e 54 75 72 6e 20 74 72 61 63 69 6e 67 20  <p>Turn tracing 
8e60: 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 64  of the virtual d
8e70: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 69  atabase engine i
8e80: 6e 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20 20  nside of the.   
8e90: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
8ea0: 6f 6e 20 61 6e 64 20 6f 66 66 2e 20 20 54 68 69  on and off.  Thi
8eb0: 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 64 65  s is used for de
8ec0: 62 75 67 67 69 6e 67 2e 3c 2f 70 3e 3c 2f 6c 69  bugging.</p></li
8ed0: 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 4e 6f 20 65  >.</ul>..<p>No e
8ee0: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73 20  rror message is 
8ef0: 67 65 6e 65 72 61 74 65 64 20 69 66 20 61 6e 20  generated if an 
8f00: 75 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 20 69  unknown pragma i
8f10: 73 20 69 73 73 75 65 64 2e 0a 55 6e 6b 6e 6f 77  s issued..Unknow
8f20: 6e 20 70 72 61 67 6d 61 73 20 61 72 65 20 69 67  n pragmas are ig
8f30: 6e 6f 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65  nored.</p>.}..Se
8f40: 63 74 69 6f 6e 20 52 45 50 4c 41 43 45 20 72 65  ction REPLACE re
8f50: 70 6c 61 63 65 0a 0a 53 79 6e 74 61 78 20 7b 73  place..Syntax {s
8f60: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
8f70: 52 45 50 4c 41 43 45 20 49 4e 54 4f 20 3c 74 61  REPLACE INTO <ta
8f80: 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63 6f  ble-name> [( <co
8f90: 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 56 41  lumn-list> )] VA
8fa0: 4c 55 45 53 20 28 20 3c 76 61 6c 75 65 2d 6c 69  LUES ( <value-li
8fb0: 73 74 3e 20 29 20 7c 0a 52 45 50 4c 41 43 45 20  st> ) |.REPLACE 
8fc0: 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65  INTO <table-name
8fd0: 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73  > [( <column-lis
8fe0: 74 3e 20 29 5d 20 3c 73 65 6c 65 63 74 2d 73 74  t> )] <select-st
8ff0: 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73  atement>.}..puts
9000: 20 7b 0a 3c 70 3e 54 68 65 20 52 45 50 4c 41 43   {.<p>The REPLAC
9010: 45 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e 20  E command is an 
9020: 61 6c 69 61 73 20 66 6f 72 20 74 68 65 20 22 49  alias for the "I
9030: 4e 53 45 52 54 20 4f 52 20 52 45 50 4c 41 43 45  NSERT OR REPLACE
9040: 22 20 76 61 72 69 61 6e 74 0a 6f 66 20 74 68 65  " variant.of the
9050: 20 3c 61 20 68 72 65 66 3d 22 23 69 6e 73 65 72   <a href="#inser
9060: 74 22 3e 49 4e 53 45 52 54 20 63 6f 6d 6d 61 6e  t">INSERT comman
9070: 64 3c 2f 61 3e 2e 20 20 54 68 69 73 20 61 6c 69  d</a>.  This ali
9080: 61 73 20 69 73 20 70 72 6f 76 69 64 65 64 20 66  as is provided f
9090: 6f 72 0a 63 6f 6d 70 61 74 69 62 69 6c 69 74 79  or.compatibility
90a0: 20 77 69 74 68 20 4d 79 53 51 4c 2e 20 20 53 65   with MySQL.  Se
90b0: 65 20 74 68 65 20 0a 3c 61 20 68 72 65 66 3d 22  e the .<a href="
90c0: 23 69 6e 73 65 72 74 22 3e 49 4e 53 45 52 54 20  #insert">INSERT 
90d0: 63 6f 6d 6d 61 6e 64 3c 2f 61 3e 20 64 6f 63 75  command</a> docu
90e0: 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61 64  mentation for ad
90f0: 64 69 74 69 6f 6e 61 6c 0a 69 6e 66 6f 72 6d 61  ditional.informa
9100: 74 69 6f 6e 2e 3c 2f 70 3e 20 20 0a 7d 0a 0a 53  tion.</p>  .}..S
9110: 65 63 74 69 6f 6e 20 53 45 4c 45 43 54 20 73 65  ection SELECT se
9120: 6c 65 63 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71  lect..Syntax {sq
9130: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 53  l-statement} {.S
9140: 45 4c 45 43 54 20 3c 72 65 73 75 6c 74 3e 20 5b  ELECT <result> [
9150: 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6c 69 73 74  FROM <table-list
9160: 3e 5d 0a 5b 57 48 45 52 45 20 3c 65 78 70 72 65  >].[WHERE <expre
9170: 73 73 69 6f 6e 3e 5d 0a 5b 47 52 4f 55 50 20 42  ssion>].[GROUP B
9180: 59 20 3c 65 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b  Y <expr-list>].[
9190: 48 41 56 49 4e 47 20 3c 65 78 70 72 65 73 73 69  HAVING <expressi
91a0: 6f 6e 3e 5d 0a 5b 3c 63 6f 6d 70 6f 75 6e 64 2d  on>].[<compound-
91b0: 6f 70 3e 20 3c 73 65 6c 65 63 74 3e 5d 2a 0a 5b  op> <select>]*.[
91c0: 4f 52 44 45 52 20 42 59 20 3c 73 6f 72 74 2d 65  ORDER BY <sort-e
91d0: 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b 4c 49 4d 49  xpr-list>].[LIMI
91e0: 54 20 3c 69 6e 74 65 67 65 72 3e 20 5b 4f 46 46  T <integer> [OFF
91f0: 53 45 54 20 3c 69 6e 74 65 67 65 72 3e 5d 5d 0a  SET <integer>]].
9200: 7d 20 7b 72 65 73 75 6c 74 7d 20 7b 0a 3c 72 65  } {result} {.<re
9210: 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 20 5b 2c 20  sult-column> [, 
9220: 3c 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e 5d  <result-column>]
9230: 2a 0a 7d 20 7b 72 65 73 75 6c 74 2d 63 6f 6c 75  *.} {result-colu
9240: 6d 6e 7d 20 7b 0a 53 54 41 52 20 7c 20 3c 65 78  mn} {.STAR | <ex
9250: 70 72 65 73 73 69 6f 6e 3e 20 5b 20 5b 41 53 5d  pression> [ [AS]
9260: 20 3c 73 74 72 69 6e 67 3e 20 5d 0a 7d 20 7b 74   <string> ].} {t
9270: 61 62 6c 65 2d 6c 69 73 74 7d 20 7b 0a 3c 74 61  able-list} {.<ta
9280: 62 6c 65 3e 20 5b 2c 20 3c 74 61 62 6c 65 3e 5d  ble> [, <table>]
9290: 2a 0a 7d 20 7b 74 61 62 6c 65 7d 20 7b 0a 3c 74  *.} {table} {.<t
92a0: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 41 53 20 3c  able-name> [AS <
92b0: 61 6c 69 61 73 3e 5d 20 7c 0a 28 20 3c 73 65 6c  alias>] |.( <sel
92c0: 65 63 74 3e 20 29 20 5b 41 53 20 3c 61 6c 69 61  ect> ) [AS <alia
92d0: 73 3e 5d 0a 7d 20 7b 73 6f 72 74 2d 65 78 70 72  s>].} {sort-expr
92e0: 2d 6c 69 73 74 7d 20 7b 0a 3c 65 78 70 72 3e 20  -list} {.<expr> 
92f0: 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20 5b  [<sort-order>] [
9300: 2c 20 3c 65 78 70 72 3e 20 5b 3c 73 6f 72 74 2d  , <expr> [<sort-
9310: 6f 72 64 65 72 3e 5d 5d 2a 0a 7d 20 7b 73 6f 72  order>]]*.} {sor
9320: 74 2d 6f 72 64 65 72 7d 20 7b 0a 41 53 43 20 7c  t-order} {.ASC |
9330: 20 44 45 53 43 0a 7d 20 7b 63 6f 6d 70 6f 75 6e   DESC.} {compoun
9340: 64 5f 6f 70 7d 20 7b 0a 55 4e 49 4f 4e 20 7c 20  d_op} {.UNION | 
9350: 55 4e 49 4f 4e 20 41 4c 4c 20 7c 20 49 4e 54 45  UNION ALL | INTE
9360: 52 53 45 43 54 20 7c 20 45 58 43 45 50 54 0a 7d  RSECT | EXCEPT.}
9370: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
9380: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74  SELECT statement
9390: 20 69 73 20 75 73 65 64 20 74 6f 20 71 75 65 72   is used to quer
93a0: 79 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  y the database. 
93b0: 20 54 68 65 0a 72 65 73 75 6c 74 20 6f 66 20 61   The.result of a
93c0: 20 53 45 4c 45 43 54 20 69 73 20 7a 65 72 6f 20   SELECT is zero 
93d0: 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66 20  or more rows of 
93e0: 64 61 74 61 20 77 68 65 72 65 20 65 61 63 68 20  data where each 
93f0: 72 6f 77 0a 68 61 73 20 61 20 66 69 78 65 64 20  row.has a fixed 
9400: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
9410: 73 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f  s.  The number o
9420: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65  f columns in the
9430: 0a 72 65 73 75 6c 74 20 69 73 20 73 70 65 63 69  .result is speci
9440: 66 69 65 64 20 62 79 20 74 68 65 20 65 78 70 72  fied by the expr
9450: 65 73 73 69 6f 6e 20 6c 69 73 74 20 69 6e 20 62  ession list in b
9460: 65 74 77 65 65 6e 20 74 68 65 0a 53 45 4c 45 43  etween the.SELEC
9470: 54 20 61 6e 64 20 46 52 4f 4d 20 6b 65 79 77 6f  T and FROM keywo
9480: 72 64 73 2e 20 20 41 6e 79 20 61 72 62 69 74 72  rds.  Any arbitr
9490: 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e 20 63  ary expression c
94a0: 61 6e 20 62 65 20 75 73 65 64 0a 61 73 20 61 20  an be used.as a 
94b0: 72 65 73 75 6c 74 2e 20 20 49 66 20 61 20 72 65  result.  If a re
94c0: 73 75 6c 74 20 65 78 70 72 65 73 73 69 6f 6e 20  sult expression 
94d0: 69 73 20 7d 0a 70 75 74 73 20 22 5b 4f 70 65 72  is }.puts "[Oper
94e0: 61 74 6f 72 20 2a 5d 20 74 68 65 6e 20 61 6c 6c  ator *] then all
94f0: 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6c 6c 20   columns of all 
9500: 74 61 62 6c 65 73 20 61 72 65 20 73 75 62 73 74  tables are subst
9510: 69 74 75 74 65 64 22 0a 70 75 74 73 20 7b 66 6f  ituted".puts {fo
9520: 72 20 74 68 61 74 20 6f 6e 65 20 65 78 70 72 65  r that one expre
9530: 73 73 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  ssion.</p>..<p>T
9540: 68 65 20 71 75 65 72 79 20 69 73 20 65 78 65 63  he query is exec
9550: 75 74 65 64 20 61 67 61 69 6e 20 6f 6e 65 20 6f  uted again one o
9560: 72 20 6d 6f 72 65 20 74 61 62 6c 65 73 20 73 70  r more tables sp
9570: 65 63 69 66 69 65 64 20 61 66 74 65 72 0a 74 68  ecified after.th
9580: 65 20 46 52 4f 4d 20 6b 65 79 77 6f 72 64 2e 20  e FROM keyword. 
9590: 20 49 66 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e   If more than on
95a0: 65 20 74 61 62 6c 65 20 69 73 20 73 70 65 63 69  e table is speci
95b0: 66 69 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 71  fied, then the.q
95c0: 75 65 72 79 20 69 73 20 61 67 61 69 6e 73 74 20  uery is against 
95d0: 74 68 65 20 28 69 6e 6e 65 72 29 20 6a 6f 69 6e  the (inner) join
95e0: 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20   of the various 
95f0: 74 61 62 6c 65 73 2e 20 20 41 20 73 75 62 2d 71  tables.  A sub-q
9600: 75 65 72 79 0a 69 6e 20 70 61 72 65 6e 74 68 65  uery.in parenthe
9610: 73 65 73 20 6d 61 79 20 62 65 20 73 75 62 73 74  ses may be subst
9620: 69 74 75 74 65 64 20 66 6f 72 20 61 6e 79 20 74  ituted for any t
9630: 61 62 6c 65 20 6e 61 6d 65 20 69 6e 20 74 68 65  able name in the
9640: 20 46 52 4f 4d 20 63 6c 61 75 73 65 2e 0a 54 68   FROM clause..Th
9650: 65 20 65 6e 74 69 72 65 20 46 52 4f 4d 20 63 6c  e entire FROM cl
9660: 61 75 73 65 20 6d 61 79 20 62 65 20 6f 6d 69 74  ause may be omit
9670: 74 65 64 2c 20 69 6e 20 77 68 69 63 68 20 63 61  ted, in which ca
9680: 73 65 20 74 68 65 20 72 65 73 75 6c 74 20 69 73  se the result is
9690: 20 61 0a 73 69 6e 67 6c 65 20 72 6f 77 20 63 6f   a.single row co
96a0: 6e 73 69 73 74 69 6e 67 20 6f 66 20 74 68 65 20  nsisting of the 
96b0: 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 65 78  values of the ex
96c0: 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 2e 0a 3c  pression list..<
96d0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 57 48 45 52  /p>..<p>The WHER
96e0: 45 20 63 6c 61 75 73 65 20 63 61 6e 20 62 65 20  E clause can be 
96f0: 75 73 65 64 20 74 6f 20 6c 69 6d 69 74 20 74 68  used to limit th
9700: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73  e number of rows
9710: 20 6f 76 65 72 0a 77 68 69 63 68 20 74 68 65 20   over.which the 
9720: 71 75 65 72 79 20 6f 70 65 72 61 74 65 73 2e 20  query operates. 
9730: 20 49 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20   In the current 
9740: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 0a  implementation,.
9750: 69 6e 64 69 63 65 73 20 77 69 6c 6c 20 6f 6e 6c  indices will onl
9760: 79 20 62 65 20 75 73 65 64 20 74 6f 0a 6f 70 74  y be used to.opt
9770: 69 6d 69 7a 65 20 74 68 65 20 71 75 65 72 79 20  imize the query 
9780: 69 66 20 57 48 45 52 45 20 65 78 70 72 65 73 73  if WHERE express
9790: 69 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 65 71 75  ion contains equ
97a0: 61 6c 69 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e  ality comparison
97b0: 73 0a 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 74  s.connected by t
97c0: 68 65 20 41 4e 44 20 6f 70 65 72 61 74 6f 72 2e  he AND operator.
97d0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47 52 4f  </p>..<p>The GRO
97e0: 55 50 20 42 59 20 63 6c 61 75 73 65 73 20 63 61  UP BY clauses ca
97f0: 75 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  uses one or more
9800: 20 72 6f 77 73 20 6f 66 20 74 68 65 20 72 65 73   rows of the res
9810: 75 6c 74 20 74 6f 0a 62 65 20 63 6f 6d 62 69 6e  ult to.be combin
9820: 65 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65  ed into a single
9830: 20 72 6f 77 20 6f 66 20 6f 75 74 70 75 74 2e 20   row of output. 
9840: 20 54 68 69 73 20 69 73 20 65 73 70 65 63 69 61   This is especia
9850: 6c 6c 79 20 75 73 65 66 75 6c 0a 77 68 65 6e 20  lly useful.when 
9860: 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6e 74 61  the result conta
9870: 69 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 75  ins aggregate fu
9880: 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20 65 78  nctions.  The ex
9890: 70 72 65 73 73 69 6f 6e 73 20 69 6e 0a 74 68 65  pressions in.the
98a0: 20 47 52 4f 55 50 20 42 59 20 63 6c 61 75 73 65   GROUP BY clause
98b0: 20 64 6f 20 3c 65 6d 3e 6e 6f 74 3c 2f 65 6d 3e   do <em>not</em>
98c0: 20 68 61 76 65 20 74 6f 20 62 65 20 65 78 70 72   have to be expr
98d0: 65 73 73 69 6f 6e 73 20 74 68 61 74 0a 61 70 70  essions that.app
98e0: 65 61 72 20 69 6e 20 74 68 65 20 72 65 73 75 6c  ear in the resul
98f0: 74 2e 20 20 54 68 65 20 48 41 56 49 4e 47 20 63  t.  The HAVING c
9900: 6c 61 75 73 65 20 69 73 20 73 69 6d 69 6c 61 72  lause is similar
9910: 20 74 6f 20 57 48 45 52 45 20 65 78 63 65 70 74   to WHERE except
9920: 0a 74 68 61 74 20 48 41 56 49 4e 47 20 61 70 70  .that HAVING app
9930: 6c 69 65 73 20 61 66 74 65 72 20 67 72 6f 75 70  lies after group
9940: 69 6e 67 20 68 61 73 20 6f 63 63 75 72 72 65 64  ing has occurred
9950: 2e 20 20 54 68 65 20 48 41 56 49 4e 47 20 65 78  .  The HAVING ex
9960: 70 72 65 73 73 69 6f 6e 0a 6d 61 79 20 72 65 66  pression.may ref
9970: 65 72 20 74 6f 20 76 61 6c 75 65 73 2c 20 65 76  er to values, ev
9980: 65 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e  en aggregate fun
9990: 63 74 69 6f 6e 73 2c 20 74 68 61 74 20 61 72 65  ctions, that are
99a0: 20 6e 6f 74 20 69 6e 20 74 68 65 20 72 65 73 75   not in the resu
99b0: 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  lt.</p>..<p>The 
99c0: 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20  ORDER BY clause 
99d0: 63 61 75 73 65 73 20 74 68 65 20 6f 75 74 70 75  causes the outpu
99e0: 74 20 72 6f 77 73 20 74 6f 20 62 65 20 73 6f 72  t rows to be sor
99f0: 74 65 64 2e 20 20 0a 54 68 65 20 61 72 67 75 6d  ted.  .The argum
9a00: 65 6e 74 20 74 6f 20 4f 52 44 45 52 20 42 59 20  ent to ORDER BY 
9a10: 69 73 20 61 20 6c 69 73 74 20 6f 66 20 65 78 70  is a list of exp
9a20: 72 65 73 73 69 6f 6e 73 20 74 68 61 74 20 61 72  ressions that ar
9a30: 65 20 75 73 65 64 20 61 73 20 74 68 65 0a 6b 65  e used as the.ke
9a40: 79 20 66 6f 72 20 74 68 65 20 73 6f 72 74 2e 20  y for the sort. 
9a50: 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73   The expressions
9a60: 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 20   do not have to 
9a70: 62 65 20 70 61 72 74 20 6f 66 20 74 68 65 0a 72  be part of the.r
9a80: 65 73 75 6c 74 20 66 6f 72 20 61 20 73 69 6d 70  esult for a simp
9a90: 6c 65 20 53 45 4c 45 43 54 2c 20 62 75 74 20 69  le SELECT, but i
9aa0: 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c  n a compound SEL
9ab0: 45 43 54 20 65 61 63 68 20 73 6f 72 74 0a 65 78  ECT each sort.ex
9ac0: 70 72 65 73 73 69 6f 6e 20 6d 75 73 74 20 65 78  pression must ex
9ad0: 61 63 74 6c 79 20 6d 61 74 63 68 20 6f 6e 65 20  actly match one 
9ae0: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f  of the result co
9af0: 6c 75 6d 6e 73 2e 20 20 45 61 63 68 0a 73 6f 72  lumns.  Each.sor
9b00: 74 20 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 79  t expression may
9b10: 20 62 65 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 66   be optionally f
9b20: 6f 6c 6c 6f 77 65 64 20 62 79 20 41 53 43 20 6f  ollowed by ASC o
9b30: 72 20 44 45 53 43 20 74 6f 20 73 70 65 63 69 66  r DESC to specif
9b40: 79 0a 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72  y.the sort order
9b50: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4c 49  .</p>..<p>The LI
9b60: 4d 49 54 20 63 6c 61 75 73 65 20 70 6c 61 63 65  MIT clause place
9b70: 73 20 61 6e 20 75 70 70 65 72 20 62 6f 75 6e 64  s an upper bound
9b80: 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   on the number o
9b90: 66 20 72 6f 77 73 0a 72 65 74 75 72 6e 65 64 20  f rows.returned 
9ba0: 69 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 20 20  in the result.  
9bb0: 41 20 4c 49 4d 49 54 20 6f 66 20 30 20 69 6e 64  A LIMIT of 0 ind
9bc0: 69 63 61 74 65 73 20 6e 6f 20 75 70 70 65 72 20  icates no upper 
9bd0: 62 6f 75 6e 64 2e 0a 54 68 65 20 6f 70 74 69 6f  bound..The optio
9be0: 6e 61 6c 20 4f 46 46 53 45 54 20 66 6f 6c 6c 6f  nal OFFSET follo
9bf0: 77 69 6e 67 20 4c 49 4d 49 54 20 73 70 65 63 69  wing LIMIT speci
9c00: 66 69 65 73 20 68 6f 77 20 6d 61 6e 79 0a 72 6f  fies how many.ro
9c10: 77 73 20 74 6f 20 73 6b 69 70 20 61 74 20 74 68  ws to skip at th
9c20: 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74  e beginning of t
9c30: 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e 3c 2f  he result set.</
9c40: 70 3e 0a 0a 3c 70 3e 41 20 63 6f 6d 70 6f 75 6e  p>..<p>A compoun
9c50: 64 20 53 45 4c 45 43 54 20 69 73 20 66 6f 72 6d  d SELECT is form
9c60: 65 64 20 66 72 6f 6d 20 74 77 6f 20 6f 72 20 6d  ed from two or m
9c70: 6f 72 65 20 73 69 6d 70 6c 65 20 53 45 4c 45 43  ore simple SELEC
9c80: 54 73 20 63 6f 6e 6e 65 63 74 65 64 0a 62 79 20  Ts connected.by 
9c90: 6f 6e 65 20 6f 66 20 74 68 65 20 6f 70 65 72 61  one of the opera
9ca0: 74 6f 72 73 20 55 4e 49 4f 4e 2c 20 55 4e 49 4f  tors UNION, UNIO
9cb0: 4e 20 41 4c 4c 2c 20 49 4e 54 45 52 53 45 43 54  N ALL, INTERSECT
9cc0: 2c 20 6f 72 20 45 58 43 45 50 54 2e 20 20 49 6e  , or EXCEPT.  In
9cd0: 0a 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45  .a compound SELE
9ce0: 43 54 2c 20 61 6c 6c 20 74 68 65 20 63 6f 6e 73  CT, all the cons
9cf0: 74 69 74 75 65 6e 74 20 53 45 4c 45 43 54 73 20  tituent SELECTs 
9d00: 6d 75 73 74 20 73 70 65 63 69 66 79 20 74 68 65  must specify the
9d10: 0a 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20  .same number of 
9d20: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20  result columns. 
9d30: 20 54 68 65 72 65 20 6d 61 79 20 62 65 20 6f 6e   There may be on
9d40: 6c 79 20 61 20 73 69 6e 67 6c 65 20 4f 52 44 45  ly a single ORDE
9d50: 52 20 42 59 0a 63 6c 61 75 73 65 20 61 74 20 74  R BY.clause at t
9d60: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 63 6f  he end of the co
9d70: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e 20 20  mpound SELECT.  
9d80: 54 68 65 20 55 4e 49 4f 4e 20 61 6e 64 20 55 4e  The UNION and UN
9d90: 49 4f 4e 20 41 4c 4c 0a 6f 70 65 72 61 74 6f 72  ION ALL.operator
9da0: 73 20 63 6f 6d 62 69 6e 65 20 74 68 65 20 72 65  s combine the re
9db0: 73 75 6c 74 73 20 6f 66 20 74 68 65 20 53 45 4c  sults of the SEL
9dc0: 45 43 54 73 20 74 6f 20 74 68 65 20 72 69 67 68  ECTs to the righ
9dd0: 74 20 61 6e 64 20 6c 65 66 74 20 69 6e 74 6f 0a  t and left into.
9de0: 61 20 73 69 6e 67 6c 65 20 62 69 67 20 74 61 62  a single big tab
9df0: 6c 65 2e 20 20 54 68 65 20 64 69 66 66 65 72 65  le.  The differe
9e00: 6e 63 65 20 69 73 20 74 68 61 74 20 69 6e 20 55  nce is that in U
9e10: 4e 49 4f 4e 20 61 6c 6c 20 72 65 73 75 6c 74 20  NION all result 
9e20: 72 6f 77 73 0a 61 72 65 20 64 69 73 74 69 6e 63  rows.are distinc
9e30: 74 20 77 68 65 72 65 20 69 6e 20 55 4e 49 4f 4e  t where in UNION
9e40: 20 41 4c 4c 20 74 68 65 72 65 20 6d 61 79 20 62   ALL there may b
9e50: 65 20 64 75 70 6c 69 63 61 74 65 73 2e 0a 54 68  e duplicates..Th
9e60: 65 20 49 4e 54 45 52 53 45 43 54 20 6f 70 65 72  e INTERSECT oper
9e70: 61 74 6f 72 20 74 61 6b 65 73 20 74 68 65 20 69  ator takes the i
9e80: 6e 74 65 72 73 65 63 74 69 6f 6e 20 6f 66 20 74  ntersection of t
9e90: 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 74 68  he results of th
9ea0: 65 0a 6c 65 66 74 20 61 6e 64 20 72 69 67 68 74  e.left and right
9eb0: 20 53 45 4c 45 43 54 73 2e 20 20 45 58 43 45 50   SELECTs.  EXCEP
9ec0: 54 20 74 61 6b 65 73 20 74 68 65 20 72 65 73 75  T takes the resu
9ed0: 6c 74 20 6f 66 20 6c 65 66 74 20 53 45 4c 45 43  lt of left SELEC
9ee0: 54 20 61 66 74 65 72 0a 72 65 6d 6f 76 69 6e 67  T after.removing
9ef0: 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20   the results of 
9f00: 74 68 65 20 72 69 67 68 74 20 53 45 4c 45 43 54  the right SELECT
9f10: 2e 20 20 57 68 65 6e 20 74 68 72 65 65 20 61 72  .  When three ar
9f20: 65 20 6d 6f 72 65 20 53 45 4c 45 43 54 73 0a 61  e more SELECTs.a
9f30: 72 65 20 63 6f 6e 6e 65 63 74 65 64 20 69 6e 74  re connected int
9f40: 6f 20 61 20 63 6f 6d 70 6f 75 6e 64 2c 20 74 68  o a compound, th
9f50: 65 79 20 67 72 6f 75 70 20 66 72 6f 6d 20 6c 65  ey group from le
9f60: 66 74 20 74 6f 20 72 69 67 68 74 2e 3c 2f 70 3e  ft to right.</p>
9f70: 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 55 50 44 41  .}..Section UPDA
9f80: 54 45 20 75 70 64 61 74 65 0a 0a 53 79 6e 74 61  TE update..Synta
9f90: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
9fa0: 7d 20 7b 0a 55 50 44 41 54 45 20 5b 20 4f 52 20  } {.UPDATE [ OR 
9fb0: 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69  <conflict-algori
9fc0: 74 68 6d 3e 20 5d 20 3c 74 61 62 6c 65 2d 6e 61  thm> ] <table-na
9fd0: 6d 65 3e 0a 53 45 54 20 3c 61 73 73 69 67 6e 6d  me>.SET <assignm
9fe0: 65 6e 74 3e 20 5b 2c 20 3c 61 73 73 69 67 6e 6d  ent> [, <assignm
9ff0: 65 6e 74 3e 5d 20 0a 5b 57 48 45 52 45 20 3c 65  ent>] .[WHERE <e
a000: 78 70 72 65 73 73 69 6f 6e 3e 5d 0a 7d 20 7b 61  xpression>].} {a
a010: 73 73 69 67 6e 6d 65 6e 74 7d 20 7b 0a 3c 63 6f  ssignment} {.<co
a020: 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 3d 20 3c 65 78  lumn-name> = <ex
a030: 70 72 65 73 73 69 6f 6e 3e 0a 7d 0a 0a 70 75 74  pression>.}..put
a040: 73 20 7b 0a 3c 70 3e 54 68 65 20 55 50 44 41 54  s {.<p>The UPDAT
a050: 45 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 75  E statement is u
a060: 73 65 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68  sed to change th
a070: 65 20 76 61 6c 75 65 20 6f 66 20 63 6f 6c 75 6d  e value of colum
a080: 6e 73 20 69 6e 20 0a 73 65 6c 65 63 74 65 64 20  ns in .selected 
a090: 72 6f 77 73 20 6f 66 20 61 20 74 61 62 6c 65 2e  rows of a table.
a0a0: 20 20 45 61 63 68 20 61 73 73 69 67 6e 6d 65 6e    Each assignmen
a0b0: 74 20 69 6e 20 61 6e 20 55 50 44 41 54 45 20 73  t in an UPDATE s
a0c0: 70 65 63 69 66 69 65 73 0a 61 20 63 6f 6c 75 6d  pecifies.a colum
a0d0: 6e 20 6e 61 6d 65 20 74 6f 20 74 68 65 20 6c 65  n name to the le
a0e0: 66 74 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73  ft of the equals
a0f0: 20 73 69 67 6e 20 61 6e 64 20 61 6e 20 61 72 62   sign and an arb
a100: 69 74 72 61 72 79 20 65 78 70 72 65 73 73 69 6f  itrary expressio
a110: 6e 0a 74 6f 20 74 68 65 20 72 69 67 68 74 2e 20  n.to the right. 
a120: 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73   The expressions
a130: 20 6d 61 79 20 75 73 65 20 74 68 65 20 76 61 6c   may use the val
a140: 75 65 73 20 6f 66 20 6f 74 68 65 72 20 63 6f 6c  ues of other col
a150: 75 6d 6e 73 2e 0a 41 6c 6c 20 65 78 70 72 65 73  umns..All expres
a160: 73 69 6f 6e 73 20 61 72 65 20 65 76 61 6c 75 61  sions are evalua
a170: 74 65 64 20 62 65 66 6f 72 65 20 61 6e 79 20 61  ted before any a
a180: 73 73 69 67 6e 6d 65 6e 74 73 20 61 72 65 20 6d  ssignments are m
a190: 61 64 65 2e 0a 41 20 57 48 45 52 45 20 63 6c 61  ade..A WHERE cla
a1a0: 75 73 65 20 63 61 6e 20 62 65 20 75 73 65 64 20  use can be used 
a1b0: 74 6f 20 72 65 73 74 72 69 63 74 20 77 68 69 63  to restrict whic
a1c0: 68 20 72 6f 77 73 20 61 72 65 20 75 70 64 61 74  h rows are updat
a1d0: 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  ed.</p>..<p>The 
a1e0: 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63  optional conflic
a1f0: 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20  t-clause allows 
a200: 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69 6f  the specificatio
a210: 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74  n of an alternat
a220: 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63  ive.constraint c
a230: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
a240: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20  on algorithm to 
a250: 75 73 65 20 64 75 72 69 6e 67 20 74 68 69 73 20  use during this 
a260: 6f 6e 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65  one command..See
a270: 20 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74   the section tit
a280: 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f  led.<a href="#co
a290: 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c  nflict">ON CONFL
a2a0: 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69  ICT</a> for addi
a2b0: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
a2c0: 6f 6e 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69  on.</p>.}..Secti
a2d0: 6f 6e 20 56 41 43 55 55 4d 20 76 61 63 75 75 6d  on VACUUM vacuum
a2e0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
a2f0: 61 74 65 6d 65 6e 74 7d 20 7b 0a 56 41 43 55 55  atement} {.VACUU
a300: 4d 20 5b 3c 69 6e 64 65 78 2d 6f 72 2d 74 61 62  M [<index-or-tab
a310: 6c 65 2d 6e 61 6d 65 3e 5d 0a 7d 0a 0a 70 75 74  le-name>].}..put
a320: 73 20 7b 0a 3c 70 3e 54 68 65 20 56 41 43 55 55  s {.<p>The VACUU
a330: 4d 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e 20  M command is an 
a340: 53 51 4c 69 74 65 20 65 78 74 65 6e 73 69 6f 6e  SQLite extension
a350: 20 6d 6f 64 65 6c 6c 65 64 20 61 66 74 65 72 20   modelled after 
a360: 61 20 73 69 6d 69 6c 61 72 0a 63 6f 6d 6d 61 6e  a similar.comman
a370: 64 20 66 6f 75 6e 64 20 69 6e 20 50 6f 73 74 67  d found in Postg
a380: 72 65 53 51 4c 2e 20 20 49 66 20 56 41 43 55 55  reSQL.  If VACUU
a390: 4d 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 69 74  M is invoked wit
a3a0: 68 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 0a  h the name of a.
a3b0: 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 20 74  table or index t
a3c0: 68 65 6e 20 69 74 20 69 73 20 73 75 70 70 6f 73  hen it is suppos
a3d0: 65 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 74 68  e to clean up th
a3e0: 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 20 6f 72  e named table or
a3f0: 20 69 6e 64 65 78 2e 0a 49 6e 20 76 65 72 73 69   index..In versi
a400: 6f 6e 20 31 2e 30 20 6f 66 20 53 51 4c 69 74 65  on 1.0 of SQLite
a410: 2c 20 74 68 65 20 56 41 43 55 55 4d 20 63 6f 6d  , the VACUUM com
a420: 6d 61 6e 64 20 77 6f 75 6c 64 20 69 6e 76 6f 6b  mand would invok
a430: 65 20 0a 3c 62 3e 67 64 62 6d 5f 72 65 6f 72 67  e .<b>gdbm_reorg
a440: 61 6e 69 7a 65 28 29 3c 2f 62 3e 20 74 6f 20 63  anize()</b> to c
a450: 6c 65 61 6e 20 75 70 20 74 68 65 20 62 61 63 6b  lean up the back
a460: 65 6e 64 20 64 61 74 61 62 61 73 65 20 66 69 6c  end database fil
a470: 65 2e 0a 42 65 67 69 6e 6e 69 6e 67 20 77 69 74  e..Beginning wit
a480: 68 20 76 65 72 73 69 6f 6e 20 32 2e 30 20 6f 66  h version 2.0 of
a490: 20 53 51 4c 69 74 65 2c 20 47 44 42 4d 20 69 73   SQLite, GDBM is
a4a0: 20 6e 6f 20 6c 6f 6e 67 65 72 20 75 73 65 64 20   no longer used 
a4b0: 66 6f 72 0a 74 68 65 20 64 61 74 61 62 61 73 65  for.the database
a4c0: 20 62 61 63 6b 65 6e 64 20 61 6e 64 20 56 41 43   backend and VAC
a4d0: 55 55 4d 20 68 61 73 20 62 65 63 6f 6d 65 20 61  UUM has become a
a4e0: 20 6e 6f 2d 6f 70 2e 0a 3c 2f 70 3e 0a 7d 0a 0a   no-op..</p>.}..
a4f0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 3c 68 72 20 2f  .puts {.<p><hr /
a500: 3e 3c 2f 70 3e 0a 3c 70 3e 3c 61 20 68 72 65 66  ></p>.<p><a href
a510: 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 3c 69  ="index.html"><i
a520: 6d 67 20 73 72 63 3d 22 2f 67 6f 62 61 63 6b 2e  mg src="/goback.
a530: 6a 70 67 22 20 62 6f 72 64 65 72 3d 30 20 2f 3e  jpg" border=0 />
a540: 0a 42 61 63 6b 20 74 6f 20 74 68 65 20 53 51 4c  .Back to the SQL
a550: 69 74 65 20 48 6f 6d 65 20 50 61 67 65 3c 2f 61  ite Home Page</a
a560: 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 62 6f 64 79 3e 3c  >.</p>..</body><
a570: 2f 68 74 6d 6c 3e 7d 0a                          /html>}.