/ Hex Artifact Content
Login

Artifact cf22bf18dbd6bec3b7d0b00ad998dd1f88193ea2:


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 34 30 20 32 30 30 32  .tcl,v 1.40 2002
0060: 2f 30 36 2f 31 32 20 32 32 3a 33 33 3a 35 34 20  /06/12 22:33:54 
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 20 20 7b 7b 43 52 45 41 54 45  view}.  {{CREATE
0650: 20 54 52 49 47 47 45 52 7d 20 63 72 65 61 74 65   TRIGGER} create
0660: 74 72 69 67 67 65 72 7d 0a 20 20 7b 7b 44 52 4f  trigger}.  {{DRO
0670: 50 20 54 52 49 47 47 45 52 7d 20 64 72 6f 70 74  P TRIGGER} dropt
0680: 72 69 67 67 65 72 7d 0a 7d 5d 20 7b 0a 20 20 70  rigger}.}] {.  p
0690: 75 74 73 20 22 3c 6c 69 3e 3c 61 20 68 72 65 66  uts "<li><a href
06a0: 3d 5c 22 23 5b 6c 69 6e 64 65 78 20 24 73 65 63  =\"#[lindex $sec
06b0: 74 69 6f 6e 20 31 5d 5c 22 3e 5b 6c 69 6e 64 65  tion 1]\">[linde
06c0: 78 20 24 73 65 63 74 69 6f 6e 20 30 5d 3c 2f 61  x $section 0]</a
06d0: 3e 3c 2f 6c 69 3e 22 0a 7d 0a 70 75 74 73 20 7b  ></li>".}.puts {
06e0: 3c 2f 75 6c 3e 3c 2f 70 3e 0a 0a 3c 70 3e 44 65  </ul></p>..<p>De
06f0: 74 61 69 6c 73 20 6f 6e 20 74 68 65 20 69 6d 70  tails on the imp
0700: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 65  lementation of e
0710: 61 63 68 20 63 6f 6d 6d 61 6e 64 20 61 72 65 20  ach command are 
0720: 70 72 6f 76 69 64 65 64 20 69 6e 0a 74 68 65 20  provided in.the 
0730: 73 65 71 75 65 6c 2e 3c 2f 70 3e 0a 7d 0a 0a 70  sequel.</p>.}..p
0740: 72 6f 63 20 53 79 6e 74 61 78 20 7b 61 72 67 73  roc Syntax {args
0750: 7d 20 7b 0a 20 20 70 75 74 73 20 7b 3c 74 61 62  } {.  puts {<tab
0760: 6c 65 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22  le cellpadding="
0770: 31 30 22 3e 7d 0a 20 20 66 6f 72 65 61 63 68 20  10">}.  foreach 
0780: 7b 72 75 6c 65 20 62 6f 64 79 7d 20 24 61 72 67  {rule body} $arg
0790: 73 20 7b 0a 20 20 20 20 70 75 74 73 20 22 3c 74  s {.    puts "<t
07a0: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 5c 22 72 69  r><td align=\"ri
07b0: 67 68 74 5c 22 20 76 61 6c 69 67 6e 3d 5c 22 74  ght\" valign=\"t
07c0: 6f 70 5c 22 3e 22 0a 20 20 20 20 70 75 74 73 20  op\">".    puts 
07d0: 22 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d  "<i><font color=
07e0: 5c 22 23 66 66 33 34 33 34 5c 22 3e 24 72 75 6c  \"#ff3434\">$rul
07f0: 65 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e 26 6e 62 73  e</font></i>&nbs
0800: 70 3b 3a 3a 3d 3c 2f 74 64 3e 22 0a 20 20 20 20  p;::=</td>".    
0810: 72 65 67 73 75 62 20 2d 61 6c 6c 20 3c 20 24 62  regsub -all < $b
0820: 6f 64 79 20 7b 25 4c 54 7d 20 62 6f 64 79 0a 20  ody {%LT} body. 
0830: 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 3e     regsub -all >
0840: 20 24 62 6f 64 79 20 7b 25 47 54 7d 20 62 6f 64   $body {%GT} bod
0850: 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c  y.    regsub -al
0860: 6c 20 25 4c 54 20 24 62 6f 64 79 20 7b 3c 2f 66  l %LT $body {</f
0870: 6f 6e 74 3e 3c 2f 62 3e 3c 69 3e 3c 66 6f 6e 74  ont></b><i><font
0880: 20 63 6f 6c 6f 72 3d 22 23 66 66 33 34 33 34 22   color="#ff3434"
0890: 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73  >} body.    regs
08a0: 75 62 20 2d 61 6c 6c 20 25 47 54 20 24 62 6f 64  ub -all %GT $bod
08b0: 79 20 7b 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e 3c 62  y {</font></i><b
08c0: 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32  ><font color="#2
08d0: 63 32 63 66 30 22 3e 7d 20 62 6f 64 79 0a 20 20  c2cf0">} body.  
08e0: 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 5b    regsub -all {[
08f0: 5d 7c 5b 2a 3f 5d 7d 20 24 62 6f 64 79 20 7b 3c  ]|[*?]} $body {<
0900: 2f 66 6f 6e 74 3e 3c 2f 62 3e 26 3c 62 3e 3c 66  /font></b>&<b><f
0910: 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63  ont color="#2c2c
0920: 66 30 22 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72  f0">} body.    r
0930: 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 22 20  egsub -all "\n" 
0940: 5b 73 74 72 69 6e 67 20 74 72 69 6d 20 24 62 6f  [string trim $bo
0950: 64 79 5d 20 22 3c 62 72 3e 5c 6e 22 20 62 6f 64  dy] "<br>\n" bod
0960: 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c  y.    regsub -al
0970: 6c 20 22 5c 6e 20 20 2a 22 20 24 62 6f 64 79 20  l "\n  *" $body 
0980: 22 5c 6e 5c 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62  "\n\\&nbsp;\\&nb
0990: 73 70 3b 5c 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62  sp;\\&nbsp;\\&nb
09a0: 73 70 3b 22 20 62 6f 64 79 0a 20 20 20 20 72 65  sp;" body.    re
09b0: 67 73 75 62 20 2d 61 6c 6c 20 7b 5b 7c 2c 2e 2a  gsub -all {[|,.*
09c0: 28 29 5d 7d 20 24 62 6f 64 79 20 7b 3c 62 69 67  ()]} $body {<big
09d0: 3e 26 3c 2f 62 69 67 3e 7d 20 62 6f 64 79 0a 20  >&</big>} body. 
09e0: 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b     regsub -all {
09f0: 20 3d 20 7d 20 24 62 6f 64 79 20 7b 20 3c 62 69   = } $body { <bi
0a00: 67 3e 3d 3c 2f 62 69 67 3e 20 7d 20 62 6f 64 79  g>=</big> } body
0a10: 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c  .    regsub -all
0a20: 20 7b 53 54 41 52 7d 20 24 62 6f 64 79 20 7b 3c   {STAR} $body {<
0a30: 62 69 67 3e 2a 3c 2f 62 69 67 3e 7d 20 62 6f 64  big>*</big>} bod
0a40: 79 0a 20 20 20 20 70 75 74 73 20 22 3c 74 64 3e  y.    puts "<td>
0a50: 3c 62 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c  <b><font color=\
0a60: 22 23 32 63 32 63 66 30 5c 22 3e 24 62 6f 64 79  "#2c2cf0\">$body
0a70: 3c 2f 66 6f 6e 74 3e 3c 2f 62 3e 3c 2f 74 64 3e  </font></b></td>
0a80: 3c 2f 74 72 3e 22 0a 20 20 7d 0a 20 20 70 75 74  </tr>".  }.  put
0a90: 73 20 7b 3c 2f 74 61 62 6c 65 3e 7d 0a 7d 0a 70  s {</table>}.}.p
0aa0: 72 6f 63 20 4f 70 65 72 61 74 6f 72 20 7b 6e 61  roc Operator {na
0ab0: 6d 65 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20 22  me} {.  return "
0ac0: 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 32  <font color=\"#2
0ad0: 63 32 63 66 30 5c 22 3e 3c 62 69 67 3e 24 6e 61  c2cf0\"><big>$na
0ae0: 6d 65 3c 2f 62 69 67 3e 3c 2f 66 6f 6e 74 3e 22  me</big></font>"
0af0: 0a 7d 0a 70 72 6f 63 20 4e 6f 6e 74 65 72 6d 69  .}.proc Nontermi
0b00: 6e 61 6c 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20 72  nal {name} {.  r
0b10: 65 74 75 72 6e 20 22 3c 69 3e 3c 66 6f 6e 74 20  eturn "<i><font 
0b20: 63 6f 6c 6f 72 3d 5c 22 23 66 66 33 34 33 34 5c  color=\"#ff3434\
0b30: 22 3e 24 6e 61 6d 65 3c 2f 66 6f 6e 74 3e 3c 2f  ">$name</font></
0b40: 69 3e 22 0a 7d 0a 70 72 6f 63 20 4b 65 79 77 6f  i>".}.proc Keywo
0b50: 72 64 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20 72 65  rd {name} {.  re
0b60: 74 75 72 6e 20 22 3c 66 6f 6e 74 20 63 6f 6c 6f  turn "<font colo
0b70: 72 3d 5c 22 23 32 63 32 63 66 30 5c 22 3e 24 6e  r=\"#2c2cf0\">$n
0b80: 61 6d 65 3c 2f 66 6f 6e 74 3e 22 0a 7d 0a 20 0a  ame</font>".}. .
0b90: 0a 70 72 6f 63 20 53 65 63 74 69 6f 6e 20 7b 6e  .proc Section {n
0ba0: 61 6d 65 20 7b 6c 61 62 65 6c 20 7b 7d 7d 7d 20  ame {label {}}} 
0bb0: 7b 0a 20 20 70 75 74 73 20 22 5c 6e 3c 68 72 20  {.  puts "\n<hr 
0bc0: 2f 3e 22 0a 20 20 69 66 20 7b 24 6c 61 62 65 6c  />".  if {$label
0bd0: 21 3d 22 22 7d 20 7b 0a 20 20 20 20 70 75 74 73  !=""} {.    puts
0be0: 20 22 3c 61 20 6e 61 6d 65 3d 5c 22 24 6c 61 62   "<a name=\"$lab
0bf0: 65 6c 5c 22 3e 22 0a 20 20 7d 0a 20 20 70 75 74  el\">".  }.  put
0c00: 73 20 22 3c 68 31 3e 24 6e 61 6d 65 3c 2f 68 31  s "<h1>$name</h1
0c10: 3e 5c 6e 22 0a 7d 0a 0a 70 72 6f 63 20 45 78 61  >\n".}..proc Exa
0c20: 6d 70 6c 65 20 7b 74 65 78 74 7d 20 7b 0a 20 20  mple {text} {.  
0c30: 70 75 74 73 20 22 3c 62 6c 6f 63 6b 71 75 6f 74  puts "<blockquot
0c40: 65 3e 3c 70 72 65 3e 24 74 65 78 74 3c 2f 70 72  e><pre>$text</pr
0c50: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 22  e></blockquote>"
0c60: 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 7b 42 45 47  .}..Section {BEG
0c70: 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 7d 20  IN TRANSACTION} 
0c80: 63 72 65 61 74 65 69 6e 64 65 78 0a 0a 53 79 6e  createindex..Syn
0c90: 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65  tax {sql-stateme
0ca0: 6e 74 7d 20 7b 0a 42 45 47 49 4e 20 5b 54 52 41  nt} {.BEGIN [TRA
0cb0: 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e  NSACTION [<name>
0cc0: 5d 5d 20 5b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20  ]] [ON CONFLICT 
0cd0: 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69  <conflict-algori
0ce0: 74 68 6d 3e 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b  thm>].}.Syntax {
0cf0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
0d00: 0a 45 4e 44 20 5b 54 52 41 4e 53 41 43 54 49 4f  .END [TRANSACTIO
0d10: 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 53 79  N [<name>]].}.Sy
0d20: 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d  ntax {sql-statem
0d30: 65 6e 74 7d 20 7b 0a 43 4f 4d 4d 49 54 20 5b 54  ent} {.COMMIT [T
0d40: 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d  RANSACTION [<nam
0d50: 65 3e 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b 73  e>]].}.Syntax {s
0d60: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
0d70: 52 4f 4c 4c 42 41 43 4b 20 5b 54 52 41 4e 53 41  ROLLBACK [TRANSA
0d80: 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a  CTION [<name>]].
0d90: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 42 65 67  }..puts {.<p>Beg
0da0: 69 6e 6e 69 6e 67 20 69 6e 20 76 65 72 73 69 6f  inning in versio
0db0: 6e 20 32 2e 30 2c 20 53 51 4c 69 74 65 20 73 75  n 2.0, SQLite su
0dc0: 70 70 6f 72 74 73 20 74 72 61 6e 73 61 63 74 69  pports transacti
0dd0: 6f 6e 73 20 77 69 74 68 0a 72 6f 6c 6c 62 61 63  ons with.rollbac
0de0: 6b 20 61 6e 64 20 61 74 6f 6d 69 63 20 63 6f 6d  k and atomic com
0df0: 6d 69 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4e 6f  mit.</p>..<p>.No
0e00: 20 63 68 61 6e 67 65 73 20 63 61 6e 20 62 65 20   changes can be 
0e10: 6d 61 64 65 20 74 6f 20 74 68 65 20 64 61 74 61  made to the data
0e20: 62 61 73 65 20 65 78 63 65 70 74 20 77 69 74 68  base except with
0e30: 69 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e  in a transaction
0e40: 2e 0a 41 6e 79 20 63 6f 6d 6d 61 6e 64 20 74 68  ..Any command th
0e50: 61 74 20 63 68 61 6e 67 65 73 20 74 68 65 20 64  at changes the d
0e60: 61 74 61 62 61 73 65 20 28 62 61 73 69 63 61 6c  atabase (basical
0e70: 6c 79 2c 20 61 6e 79 20 53 51 4c 20 63 6f 6d 6d  ly, any SQL comm
0e80: 61 6e 64 0a 6f 74 68 65 72 20 74 68 61 6e 20 53  and.other than S
0e90: 45 4c 45 43 54 29 20 77 69 6c 6c 20 61 75 74 6f  ELECT) will auto
0ea0: 6d 61 74 69 63 61 6c 6c 79 20 73 74 61 72 74 73  matically starts
0eb0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
0ec0: 66 0a 6f 6e 65 20 69 73 20 6e 6f 74 20 61 6c 72  f.one is not alr
0ed0: 65 61 64 79 20 69 6e 20 65 66 66 65 63 74 2e 20  eady in effect. 
0ee0: 20 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73   Automatically s
0ef0: 74 61 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f  tared transactio
0f00: 6e 73 0a 61 72 65 20 63 6f 6d 6d 69 74 74 65 64  ns.are committed
0f10: 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69   at the conclusi
0f20: 6f 6e 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e  on of the comman
0f30: 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 72 61  d..</p>..<p>.Tra
0f40: 6e 73 61 63 74 69 6f 6e 73 20 63 61 6e 20 62 65  nsactions can be
0f50: 20 73 74 61 72 74 65 64 20 6d 61 6e 75 61 6c 6c   started manuall
0f60: 79 20 75 73 69 6e 67 20 74 68 65 20 42 45 47 49  y using the BEGI
0f70: 4e 0a 63 6f 6d 6d 61 6e 64 2e 20 53 75 63 68 20  N.command. Such 
0f80: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 75 73 75  transactions usu
0f90: 61 6c 6c 79 20 70 65 72 73 69 73 74 20 75 6e 74  ally persist unt
0fa0: 69 6c 20 74 68 65 20 6e 65 78 74 0a 43 4f 4d 4d  il the next.COMM
0fb0: 49 54 20 6f 72 20 52 4f 4c 4c 42 41 43 4b 20 63  IT or ROLLBACK c
0fc0: 6f 6d 6d 61 6e 64 2e 20 42 75 74 20 61 20 74 72  ommand. But a tr
0fd0: 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20 61  ansaction will a
0fe0: 6c 73 6f 20 0a 52 4f 4c 4c 42 41 43 4b 20 69 66  lso .ROLLBACK if
0ff0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
1000: 20 63 6c 6f 73 65 64 20 6f 72 20 69 66 20 61 6e   closed or if an
1010: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 0a 61 6e   error occurs.an
1020: 64 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b 20 63  d the ROLLBACK c
1030: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
1040: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20  on algorithm is 
1050: 73 70 65 63 69 66 69 65 64 2e 0a 53 65 65 20 74  specified..See t
1060: 68 65 20 64 6f 63 75 6d 65 6e 74 69 6f 6e 20 6f  he documention o
1070: 6e 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 23  n the <a href="#
1080: 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e  conflict">ON CON
1090: 46 4c 49 43 54 3c 2f 61 3e 0a 63 6c 61 75 73 65  FLICT</a>.clause
10a0: 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20   for additional 
10b0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75  information abou
10c0: 74 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b 0a 63  t the ROLLBACK.c
10d0: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
10e0: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2e 0a 3c 2f  on algorithm..</
10f0: 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 6f 70 74 69  p>..<p>.The opti
1100: 6f 6e 61 6c 20 4f 4e 20 43 4f 4e 46 4c 49 43 54  onal ON CONFLICT
1110: 20 63 6c 61 75 73 65 20 61 74 20 74 68 65 20 65   clause at the e
1120: 6e 64 20 6f 66 20 61 20 42 45 47 49 4e 20 73 74  nd of a BEGIN st
1130: 61 74 65 6d 65 6e 74 0a 63 61 6e 20 62 65 20 75  atement.can be u
1140: 73 65 64 20 74 6f 20 63 68 61 6e 67 65 64 20 74  sed to changed t
1150: 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 6c  he default confl
1160: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
1170: 6c 67 6f 72 69 74 68 6d 2e 0a 54 68 65 20 6e 6f  lgorithm..The no
1180: 72 6d 61 6c 20 64 65 66 61 75 6c 74 20 69 73 20  rmal default is 
1190: 41 42 4f 52 54 2e 20 20 49 66 20 61 6e 20 61 6c  ABORT.  If an al
11a0: 74 65 72 6e 61 74 69 76 65 20 69 73 20 73 70 65  ternative is spe
11b0: 63 69 66 69 65 64 20 62 79 0a 74 68 65 20 4f 4e  cified by.the ON
11c0: 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65   CONFLICT clause
11d0: 20 6f 66 20 61 20 42 45 47 49 4e 2c 20 74 68 65   of a BEGIN, the
11e0: 6e 20 74 68 61 74 20 61 6c 74 65 72 6e 61 74 69  n that alternati
11f0: 76 65 20 69 73 20 75 73 65 64 0a 61 73 20 74 68  ve is used.as th
1200: 65 20 64 65 66 61 75 6c 74 20 66 6f 72 20 61 6c  e default for al
1210: 6c 20 63 6f 6d 6d 61 6e 64 73 20 77 69 74 68 69  l commands withi
1220: 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  n the transactio
1230: 6e 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 0a  n.  The default.
1240: 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 6f 76 65  algorithm is ove
1250: 72 72 69 64 64 65 6e 20 62 79 20 4f 4e 20 43 4f  rridden by ON CO
1260: 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 73 20 6f  NFLICT clauses o
1270: 6e 20 69 6e 64 69 76 69 64 75 61 6c 0a 63 6f 6e  n individual.con
1280: 73 74 72 61 69 6e 74 73 20 77 69 74 68 69 6e 20  straints within 
1290: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
12a0: 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45 58   or CREATE INDEX
12b0: 20 73 74 61 74 65 6d 65 6e 74 73 0a 61 6e 64 20   statements.and 
12c0: 62 79 20 74 68 65 20 4f 52 20 63 6c 61 75 73 65  by the OR clause
12d0: 73 20 6f 6e 20 43 4f 50 59 2c 20 49 4e 53 45 52  s on COPY, INSER
12e0: 54 2c 20 61 6e 64 20 55 50 44 41 54 45 20 63 6f  T, and UPDATE co
12f0: 6d 6d 61 6e 64 73 2e 0a 3c 2f 70 3e 0a 7d 0a 0a  mmands..</p>.}..
1300: 53 65 63 74 69 6f 6e 20 43 4f 50 59 20 63 6f 70  Section COPY cop
1310: 79 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  y..Syntax {sql-s
1320: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 4f 50 59  tatement} {.COPY
1330: 20 5b 20 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d   [ OR <conflict-
1340: 61 6c 67 6f 72 69 74 68 6d 3e 20 5d 20 3c 74 61  algorithm> ] <ta
1350: 62 6c 65 2d 6e 61 6d 65 3e 20 46 52 4f 4d 20 3c  ble-name> FROM <
1360: 66 69 6c 65 6e 61 6d 65 3e 0a 5b 20 55 53 49 4e  filename>.[ USIN
1370: 47 20 44 45 4c 49 4d 49 54 45 52 53 20 3c 64 65  G DELIMITERS <de
1380: 6c 69 6d 3e 20 5d 0a 7d 0a 0a 0a 70 75 74 73 20  lim> ].}...puts 
1390: 7b 0a 3c 70 3e 54 68 65 20 43 4f 50 59 20 63 6f  {.<p>The COPY co
13a0: 6d 6d 61 6e 64 20 69 73 20 61 6e 20 65 78 74 65  mmand is an exte
13b0: 6e 73 69 6f 6e 20 75 73 65 64 20 74 6f 20 6c 6f  nsion used to lo
13c0: 61 64 20 6c 61 72 67 65 20 61 6d 6f 75 6e 74 73  ad large amounts
13d0: 20 6f 66 0a 64 61 74 61 20 69 6e 74 6f 20 61 20   of.data into a 
13e0: 74 61 62 6c 65 2e 20 20 49 74 20 69 73 20 6d 6f  table.  It is mo
13f0: 64 65 6c 65 64 20 61 66 74 65 72 20 61 20 73 69  deled after a si
1400: 6d 69 6c 61 72 20 63 6f 6d 6d 61 6e 64 20 66 6f  milar command fo
1410: 75 6e 64 0a 69 6e 20 50 6f 73 74 67 72 65 53 51  und.in PostgreSQ
1420: 4c 2e 20 20 49 6e 20 66 61 63 74 2c 20 74 68 65  L.  In fact, the
1430: 20 53 51 4c 69 74 65 20 43 4f 50 59 20 63 6f 6d   SQLite COPY com
1440: 6d 61 6e 64 20 69 73 20 73 70 65 63 69 66 69 63  mand is specific
1450: 61 6c 6c 79 0a 64 65 73 69 67 6e 65 64 20 74 6f  ally.designed to
1460: 20 62 65 20 61 62 6c 65 20 74 6f 20 72 65 61 64   be able to read
1470: 20 74 68 65 20 6f 75 74 70 75 74 20 6f 66 20 74   the output of t
1480: 68 65 20 50 6f 73 74 67 72 65 53 51 4c 20 64 75  he PostgreSQL du
1490: 6d 70 0a 75 74 69 6c 69 74 79 20 3c 62 3e 70 67  mp.utility <b>pg
14a0: 5f 64 75 6d 70 3c 2f 62 3e 20 73 6f 20 74 68 61  _dump</b> so tha
14b0: 74 20 64 61 74 61 20 63 61 6e 20 62 65 20 65 61  t data can be ea
14c0: 73 69 6c 79 20 74 72 61 6e 73 66 65 72 72 65 64  sily transferred
14d0: 20 66 72 6f 6d 0a 50 6f 73 74 67 72 65 53 51 4c   from.PostgreSQL
14e0: 20 69 6e 74 6f 20 53 51 4c 69 74 65 2e 3c 70 3e   into SQLite.<p>
14f0: 0a 0a 3c 70 3e 54 68 65 20 74 61 62 6c 65 2d 6e  ..<p>The table-n
1500: 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20  ame is the name 
1510: 6f 66 20 61 6e 20 65 78 69 73 74 69 6e 67 20 74  of an existing t
1520: 61 62 6c 65 20 77 68 69 63 68 20 69 73 20 74 6f  able which is to
1530: 0a 62 65 20 66 69 6c 6c 65 64 20 77 69 74 68 20  .be filled with 
1540: 64 61 74 61 2e 20 20 54 68 65 20 66 69 6c 65 6e  data.  The filen
1550: 61 6d 65 20 69 73 20 61 20 73 74 72 69 6e 67 20  ame is a string 
1560: 6f 72 20 69 64 65 6e 74 69 66 69 65 72 20 74 68  or identifier th
1570: 61 74 0a 6e 61 6d 65 73 20 61 20 66 69 6c 65 20  at.names a file 
1580: 66 72 6f 6d 20 77 68 69 63 68 20 64 61 74 61 20  from which data 
1590: 77 69 6c 6c 20 62 65 20 72 65 61 64 2e 20 20 54  will be read.  T
15a0: 68 65 20 66 69 6c 65 6e 61 6d 65 20 63 61 6e 20  he filename can 
15b0: 62 65 0a 74 68 65 20 3c 62 3e 53 54 44 49 4e 3c  be.the <b>STDIN<
15c0: 2f 62 3e 20 74 6f 20 72 65 61 64 20 64 61 74 61  /b> to read data
15d0: 20 66 72 6f 6d 20 73 74 61 6e 64 61 72 64 20 69   from standard i
15e0: 6e 70 75 74 2e 3c 70 3e 0a 0a 3c 70 3e 45 61 63  nput.<p>..<p>Eac
15f0: 68 20 6c 69 6e 65 20 6f 66 20 74 68 65 20 69 6e  h line of the in
1600: 70 75 74 20 66 69 6c 65 20 69 73 20 63 6f 6e 76  put file is conv
1610: 65 72 74 65 64 20 69 6e 74 6f 20 61 20 73 69 6e  erted into a sin
1620: 67 6c 65 20 72 65 63 6f 72 64 0a 69 6e 20 74 68  gle record.in th
1630: 65 20 74 61 62 6c 65 2e 20 20 43 6f 6c 75 6d 6e  e table.  Column
1640: 73 20 61 72 65 20 73 65 70 61 72 61 74 65 64 20  s are separated 
1650: 62 79 20 74 61 62 73 2e 20 20 49 66 20 61 20 74  by tabs.  If a t
1660: 61 62 20 6f 63 63 75 72 73 20 61 73 0a 64 61 74  ab occurs as.dat
1670: 61 20 77 69 74 68 69 6e 20 61 20 63 6f 6c 75 6d  a within a colum
1680: 6e 2c 20 74 68 65 6e 20 74 68 61 74 20 74 61 62  n, then that tab
1690: 20 69 73 20 70 72 65 63 65 64 65 64 20 62 79 20   is preceded by 
16a0: 61 20 62 61 73 6b 73 6c 61 73 68 20 22 5c 22 0a  a baskslash "\".
16b0: 63 68 61 72 61 63 74 65 72 2e 20 20 41 20 62 61  character.  A ba
16c0: 73 6b 73 6c 61 73 68 20 69 6e 20 74 68 65 20 64  skslash in the d
16d0: 61 74 61 20 61 70 70 65 61 72 73 20 61 73 20 74  ata appears as t
16e0: 77 6f 20 62 61 63 6b 73 6c 61 73 68 65 73 20 69  wo backslashes i
16f0: 6e 0a 61 20 72 6f 77 2e 20 20 54 68 65 20 6f 70  n.a row.  The op
1700: 74 69 6f 6e 61 6c 20 55 53 49 4e 47 20 44 45 4c  tional USING DEL
1710: 49 4d 49 54 45 52 53 20 63 6c 61 75 73 65 20 63  IMITERS clause c
1720: 61 6e 20 73 70 65 63 69 66 79 20 61 20 64 65 6c  an specify a del
1730: 69 6d 69 74 65 72 0a 6f 74 68 65 72 20 74 68 61  imiter.other tha
1740: 6e 20 74 61 62 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49  n tab.</p>..<p>I
1750: 66 20 61 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73 69  f a column consi
1760: 73 74 73 20 6f 66 20 74 68 65 20 63 68 61 72 61  sts of the chara
1770: 63 74 65 72 20 22 5c 4e 22 2c 20 74 68 61 74 20  cter "\N", that 
1780: 63 6f 6c 75 6d 6e 20 69 73 20 66 69 6c 6c 65 64  column is filled
1790: 0a 77 69 74 68 20 74 68 65 20 76 61 6c 75 65 20  .with the value 
17a0: 4e 55 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  NULL.</p>..<p>Th
17b0: 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c  e optional confl
17c0: 69 63 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77  ict-clause allow
17d0: 73 20 74 68 65 20 73 70 65 63 69 66 69 63 61 74  s the specificat
17e0: 69 6f 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e  ion of an altern
17f0: 61 74 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74  ative.constraint
1800: 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75   conflict resolu
1810: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 74  tion algorithm t
1820: 6f 20 75 73 65 20 66 6f 72 20 74 68 69 73 20 6f  o use for this o
1830: 6e 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20  ne command..See 
1840: 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c  the section titl
1850: 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e  ed.<a href="#con
1860: 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49  flict">ON CONFLI
1870: 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74  CT</a> for addit
1880: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
1890: 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20  n.</p>..<p>When 
18a0: 74 68 65 20 69 6e 70 75 74 20 64 61 74 61 20 73  the input data s
18b0: 6f 75 72 63 65 20 69 73 20 53 54 44 49 4e 2c 20  ource is STDIN, 
18c0: 74 68 65 20 69 6e 70 75 74 20 63 61 6e 20 62 65  the input can be
18d0: 20 74 65 72 6d 69 6e 61 74 65 64 0a 62 79 20 61   terminated.by a
18e0: 20 6c 69 6e 65 20 74 68 61 74 20 63 6f 6e 74 61   line that conta
18f0: 69 6e 73 20 6f 6e 6c 79 20 61 20 62 61 73 6b 73  ins only a basks
1900: 6c 61 73 68 20 61 6e 64 20 61 20 64 6f 74 3a 7d  lash and a dot:}
1910: 0a 70 75 74 73 20 22 5c 22 5b 4f 70 65 72 61 74  .puts "\"[Operat
1920: 6f 72 20 5c 5c 2e 5d 5c 22 2e 3c 2f 70 3e 22 0a  or \\.]\".</p>".
1930: 0a 53 65 63 74 69 6f 6e 20 7b 43 52 45 41 54 45  .Section {CREATE
1940: 20 49 4e 44 45 58 7d 20 63 72 65 61 74 65 69 6e   INDEX} createin
1950: 64 65 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  dex..Syntax {sql
1960: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52  -statement} {.CR
1970: 45 41 54 45 20 5b 55 4e 49 51 55 45 5d 20 49 4e  EATE [UNIQUE] IN
1980: 44 45 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e  DEX <index-name>
1990: 20 0a 4f 4e 20 3c 74 61 62 6c 65 2d 6e 61 6d 65   .ON <table-name
19a0: 3e 20 28 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65  > ( <column-name
19b0: 3e 20 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d  > [, <column-nam
19c0: 65 3e 5d 2a 20 29 0a 5b 20 4f 4e 20 43 4f 4e 46  e>]* ).[ ON CONF
19d0: 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63 74 2d 61  LICT <conflict-a
19e0: 6c 67 6f 72 69 74 68 6d 3e 20 5d 0a 7d 20 7b 63  lgorithm> ].} {c
19f0: 6f 6c 75 6d 6e 2d 6e 61 6d 65 7d 20 7b 0a 3c 6e  olumn-name} {.<n
1a00: 61 6d 65 3e 20 5b 20 41 53 43 20 7c 20 44 45 53  ame> [ ASC | DES
1a10: 43 20 5d 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c  C ].}...puts {.<
1a20: 70 3e 54 68 65 20 43 52 45 41 54 45 20 49 4e 44  p>The CREATE IND
1a30: 45 58 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69  EX command consi
1a40: 73 74 73 20 6f 66 20 74 68 65 20 6b 65 79 77 6f  sts of the keywo
1a50: 72 64 73 20 22 43 52 45 41 54 45 20 49 4e 44 45  rds "CREATE INDE
1a60: 58 22 20 66 6f 6c 6c 6f 77 65 64 0a 62 79 20 74  X" followed.by t
1a70: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6e  he name of the n
1a80: 65 77 20 69 6e 64 65 78 2c 20 74 68 65 20 6b 65  ew index, the ke
1a90: 79 77 6f 72 64 20 22 4f 4e 22 2c 20 74 68 65 20  yword "ON", the 
1aa0: 6e 61 6d 65 20 6f 66 20 61 20 70 72 65 76 69 6f  name of a previo
1ab0: 75 73 6c 79 0a 63 72 65 61 74 65 64 20 74 61 62  usly.created tab
1ac0: 6c 65 20 74 68 61 74 20 69 73 20 74 6f 20 62 65  le that is to be
1ad0: 20 69 6e 64 65 78 65 64 2c 20 61 6e 64 20 61 20   indexed, and a 
1ae0: 70 61 72 65 6e 74 68 65 73 69 7a 65 64 20 6c 69  parenthesized li
1af0: 73 74 20 6f 66 20 6e 61 6d 65 73 20 6f 66 0a 63  st of names of.c
1b00: 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61  olumns in the ta
1b10: 62 6c 65 20 74 68 61 74 20 61 72 65 20 75 73 65  ble that are use
1b20: 64 20 66 6f 72 20 74 68 65 20 69 6e 64 65 78 20  d for the index 
1b30: 6b 65 79 2e 0a 45 61 63 68 20 63 6f 6c 75 6d 6e  key..Each column
1b40: 20 6e 61 6d 65 20 63 61 6e 20 62 65 20 66 6f 6c   name can be fol
1b50: 6c 6f 77 65 64 20 62 79 20 6f 6e 65 20 6f 66 20  lowed by one of 
1b60: 74 68 65 20 22 41 53 43 22 20 6f 72 20 22 44 45  the "ASC" or "DE
1b70: 53 43 22 20 6b 65 79 77 6f 72 64 73 0a 74 6f 20  SC" keywords.to 
1b80: 69 6e 64 69 63 61 74 65 20 73 6f 72 74 20 6f 72  indicate sort or
1b90: 64 65 72 2c 20 62 75 74 20 74 68 65 20 73 6f 72  der, but the sor
1ba0: 74 20 6f 72 64 65 72 20 69 73 20 69 67 6e 6f 72  t order is ignor
1bb0: 65 64 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e  ed in the curren
1bc0: 74 0a 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  t.implementation
1bd0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 72 65 20  .</p>..<p>There 
1be0: 61 72 65 20 6e 6f 20 61 72 62 69 74 72 61 72 79  are no arbitrary
1bf0: 20 6c 69 6d 69 74 73 20 6f 6e 20 74 68 65 20 6e   limits on the n
1c00: 75 6d 62 65 72 20 6f 66 20 69 6e 64 69 63 65 73  umber of indices
1c10: 20 74 68 61 74 20 63 61 6e 20 62 65 0a 61 74 74   that can be.att
1c20: 61 63 68 65 64 20 74 6f 20 61 20 73 69 6e 67 6c  ached to a singl
1c30: 65 20 74 61 62 6c 65 2c 20 6e 6f 72 20 6f 6e 20  e table, nor on 
1c40: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  the number of co
1c50: 6c 75 6d 6e 73 20 69 6e 20 61 6e 20 69 6e 64 65  lumns in an inde
1c60: 78 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68  x.</p>..<p>If th
1c70: 65 20 55 4e 49 51 55 45 20 6b 65 79 77 6f 72 64  e UNIQUE keyword
1c80: 20 61 70 70 65 61 72 73 20 62 65 74 77 65 65 6e   appears between
1c90: 20 43 52 45 41 54 45 20 61 6e 64 20 49 4e 44 45   CREATE and INDE
1ca0: 58 20 74 68 65 6e 20 64 75 70 6c 69 63 61 74 65  X then duplicate
1cb0: 0a 69 6e 64 65 78 20 65 6e 74 72 69 65 73 20 61  .index entries a
1cc0: 72 65 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 2e 20  re not allowed. 
1cd0: 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20   Any attempt to 
1ce0: 69 6e 73 65 72 74 20 61 20 64 75 70 6c 69 63 61  insert a duplica
1cf0: 74 65 20 65 6e 74 72 79 0a 77 69 6c 6c 20 72 65  te entry.will re
1d00: 73 75 6c 74 20 69 6e 20 61 20 72 6f 6c 6c 62 61  sult in a rollba
1d10: 63 6b 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 20  ck and an error 
1d20: 6d 65 73 73 61 67 65 2e 3c 2f 70 3e 0a 0a 3c 70  message.</p>..<p
1d30: 3e 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f  >The optional co
1d40: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 20 61 6c  nflict-clause al
1d50: 6c 6f 77 73 20 74 68 65 20 73 70 65 63 69 66 69  lows the specifi
1d60: 63 61 74 69 6f 6e 20 6f 66 20 61 6c 20 61 6c 74  cation of al alt
1d70: 65 72 6e 61 74 69 76 65 0a 64 65 66 61 75 6c 74  ernative.default
1d80: 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66   constraint conf
1d90: 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20  lict resolution 
1da0: 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 74 68  algorithm for th
1db0: 69 73 20 69 6e 64 65 78 2e 0a 54 68 69 73 20 6f  is index..This o
1dc0: 6e 6c 79 20 6d 61 6b 65 73 20 73 65 6e 73 65 20  nly makes sense 
1dd0: 69 66 20 74 68 65 20 55 4e 49 51 55 45 20 6b 65  if the UNIQUE ke
1de0: 79 77 6f 72 64 20 69 73 20 75 73 65 64 20 73 69  yword is used si
1df0: 6e 63 65 20 6f 74 68 65 72 77 69 73 65 0a 74 68  nce otherwise.th
1e00: 65 72 65 20 61 72 65 20 6e 6f 74 20 63 6f 6e 73  ere are not cons
1e10: 74 72 61 69 6e 74 73 20 6f 6e 20 74 68 65 20 69  traints on the i
1e20: 6e 64 65 78 2e 20 20 54 68 65 20 64 65 66 61 75  ndex.  The defau
1e30: 6c 74 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 0a  lt algorithm is.
1e40: 41 42 4f 52 54 2e 20 20 49 66 20 61 20 43 4f 50  ABORT.  If a COP
1e50: 59 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50  Y, INSERT, or UP
1e60: 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20 73  DATE statement s
1e70: 70 65 63 69 66 69 65 73 20 61 20 70 61 72 74 69  pecifies a parti
1e80: 63 75 6c 61 72 0a 63 6f 6e 66 6c 69 63 74 20 72  cular.conflict r
1e90: 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69  esolution algori
1ea0: 74 68 6d 2c 20 74 68 61 74 20 61 6c 67 6f 72 69  thm, that algori
1eb0: 74 68 6d 20 69 73 20 75 73 65 64 20 69 6e 20 70  thm is used in p
1ec0: 6c 61 63 65 20 6f 66 0a 74 68 65 20 64 65 66 61  lace of.the defa
1ed0: 75 6c 74 20 61 6c 67 6f 72 69 74 68 6d 20 73 70  ult algorithm sp
1ee0: 65 63 69 66 69 65 64 20 68 65 72 65 2e 0a 53 65  ecified here..Se
1ef0: 65 20 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69  e the section ti
1f00: 74 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63  tled.<a href="#c
1f10: 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46  onflict">ON CONF
1f20: 4c 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64  LICT</a> for add
1f30: 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74  itional informat
1f40: 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ion.</p>..<p>The
1f50: 20 65 78 61 63 74 20 74 65 78 74 0a 6f 66 20 65   exact text.of e
1f60: 61 63 68 20 43 52 45 41 54 45 20 49 4e 44 45 58  ach CREATE INDEX
1f70: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73 74   statement is st
1f80: 6f 72 65 64 20 69 6e 20 74 68 65 20 3c 62 3e 73  ored in the <b>s
1f90: 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e  qlite_master</b>
1fa0: 0a 74 61 62 6c 65 2e 20 20 45 76 65 72 79 74 69  .table.  Everyti
1fb0: 6d 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  me the database 
1fc0: 69 73 20 6f 70 65 6e 65 64 2c 20 61 6c 6c 20 43  is opened, all C
1fd0: 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74  REATE INDEX stat
1fe0: 65 6d 65 6e 74 73 0a 61 72 65 20 72 65 61 64 20  ements.are read 
1ff0: 66 72 6f 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69  from the <b>sqli
2000: 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61  te_master</b> ta
2010: 62 6c 65 20 61 6e 64 20 75 73 65 64 20 74 6f 20  ble and used to 
2020: 72 65 67 65 6e 65 72 61 74 65 0a 53 51 4c 69 74  regenerate.SQLit
2030: 65 27 73 20 69 6e 74 65 72 6e 61 6c 20 72 65 70  e's internal rep
2040: 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74  resentation of t
2050: 68 65 20 69 6e 64 65 78 20 6c 61 79 6f 75 74 2e  he index layout.
2060: 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e  </p>.}...Section
2070: 20 7b 43 52 45 41 54 45 20 54 41 42 4c 45 7d 20   {CREATE TABLE} 
2080: 7b 63 72 65 61 74 65 74 61 62 6c 65 7d 0a 0a 53  {createtable}..S
2090: 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61  yntax {sql-comma
20a0: 6e 64 7d 20 7b 0a 43 52 45 41 54 45 20 5b 54 45  nd} {.CREATE [TE
20b0: 4d 50 20 7c 20 54 45 4d 50 4f 52 41 52 59 5d 20  MP | TEMPORARY] 
20c0: 54 41 42 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d  TABLE <table-nam
20d0: 65 3e 20 28 0a 20 20 3c 63 6f 6c 75 6d 6e 2d 64  e> (.  <column-d
20e0: 65 66 3e 20 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 64  ef> [, <column-d
20f0: 65 66 3e 5d 2a 0a 20 20 5b 2c 20 3c 63 6f 6e 73  ef>]*.  [, <cons
2100: 74 72 61 69 6e 74 3e 5d 2a 0a 29 0a 7d 20 7b 73  traint>]*.).} {s
2110: 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 43 52  ql-command} {.CR
2120: 45 41 54 45 20 5b 54 45 4d 50 20 7c 20 54 45 4d  EATE [TEMP | TEM
2130: 50 4f 52 41 52 59 5d 20 54 41 42 4c 45 20 3c 74  PORARY] TABLE <t
2140: 61 62 6c 65 2d 6e 61 6d 65 3e 20 41 53 20 3c 73  able-name> AS <s
2150: 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e  elect-statement>
2160: 0a 7d 20 7b 63 6f 6c 75 6d 6e 2d 64 65 66 7d 20  .} {column-def} 
2170: 7b 0a 3c 6e 61 6d 65 3e 20 5b 3c 74 79 70 65 3e  {.<name> [<type>
2180: 5d 20 5b 3c 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74  ] [<column-const
2190: 72 61 69 6e 74 3e 5d 2a 0a 7d 20 7b 74 79 70 65  raint>]*.} {type
21a0: 7d 20 7b 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 7c  } {.<typename> |
21b0: 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 28 20 3c 6e  .<typename> ( <n
21c0: 75 6d 62 65 72 3e 20 29 20 7c 0a 3c 74 79 70 65  umber> ) |.<type
21d0: 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d 62 65 72 3e  name> ( <number>
21e0: 20 2c 20 3c 6e 75 6d 62 65 72 3e 20 29 0a 7d 20   , <number> ).} 
21f0: 7b 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61 69  {column-constrai
2200: 6e 74 7d 20 7b 0a 4e 4f 54 20 4e 55 4c 4c 20 5b  nt} {.NOT NULL [
2210: 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73   <conflict-claus
2220: 65 3e 20 5d 20 7c 0a 50 52 49 4d 41 52 59 20 4b  e> ] |.PRIMARY K
2230: 45 59 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e  EY [<sort-order>
2240: 5d 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  ] [ <conflict-cl
2250: 61 75 73 65 3e 20 5d 20 7c 0a 55 4e 49 51 55 45  ause> ] |.UNIQUE
2260: 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61   [ <conflict-cla
2270: 75 73 65 3e 20 5d 20 7c 0a 43 48 45 43 4b 20 28  use> ] |.CHECK (
2280: 20 3c 65 78 70 72 3e 20 29 20 5b 20 3c 63 6f 6e   <expr> ) [ <con
2290: 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d 20  flict-clause> ] 
22a0: 7c 0a 44 45 46 41 55 4c 54 20 3c 76 61 6c 75 65  |.DEFAULT <value
22b0: 3e 0a 7d 20 7b 63 6f 6e 73 74 72 61 69 6e 74 7d  >.} {constraint}
22c0: 20 7b 0a 50 52 49 4d 41 52 59 20 4b 45 59 20 28   {.PRIMARY KEY (
22d0: 20 3c 6e 61 6d 65 3e 20 5b 2c 20 3c 6e 61 6d 65   <name> [, <name
22e0: 3e 5d 2a 20 29 20 5b 20 3c 63 6f 6e 66 6c 69 63  >]* ) [ <conflic
22f0: 74 2d 63 6c 61 75 73 65 3e 20 5d 7c 0a 55 4e 49  t-clause> ]|.UNI
2300: 51 55 45 20 28 20 3c 6e 61 6d 65 3e 20 5b 2c 20  QUE ( <name> [, 
2310: 3c 6e 61 6d 65 3e 5d 2a 20 29 20 5b 20 3c 63 6f  <name>]* ) [ <co
2320: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d  nflict-clause> ]
2330: 20 7c 0a 43 48 45 43 4b 20 28 20 3c 65 78 70 72   |.CHECK ( <expr
2340: 3e 20 29 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d  > ) [ <conflict-
2350: 63 6c 61 75 73 65 3e 20 5d 0a 7d 20 7b 63 6f 6e  clause> ].} {con
2360: 66 6c 69 63 74 2d 63 6c 61 75 73 65 7d 20 7b 0a  flict-clause} {.
2370: 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e  ON CONFLICT <con
2380: 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e  flict-algorithm>
2390: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 41 20  .}..puts {.<p>A 
23a0: 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61  CREATE TABLE sta
23b0: 74 65 6d 65 6e 74 20 69 73 20 62 61 73 69 63 61  tement is basica
23c0: 6c 6c 79 20 74 68 65 20 6b 65 79 77 6f 72 64 73  lly the keywords
23d0: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 22 0a   "CREATE TABLE".
23e0: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68 65 20  followed by the 
23f0: 6e 61 6d 65 20 6f 66 20 61 20 6e 65 77 20 74 61  name of a new ta
2400: 62 6c 65 20 61 6e 64 20 61 20 70 61 72 65 6e 74  ble and a parent
2410: 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f 66 20  hesized list of 
2420: 63 6f 6c 75 6d 6e 0a 64 65 66 69 6e 69 74 69 6f  column.definitio
2430: 6e 73 20 61 6e 64 20 63 6f 6e 73 74 72 61 69 6e  ns and constrain
2440: 74 73 2e 20 20 54 68 65 20 74 61 62 6c 65 20 6e  ts.  The table n
2450: 61 6d 65 20 63 61 6e 20 62 65 20 65 69 74 68 65  ame can be eithe
2460: 72 20 61 6e 20 69 64 65 6e 74 69 66 69 65 72 0a  r an identifier.
2470: 6f 72 20 61 20 73 74 72 69 6e 67 2e 20 20 54 68  or a string.  Th
2480: 65 20 6f 6e 6c 79 20 72 65 73 65 72 76 65 64 20  e only reserved 
2490: 74 61 62 6c 65 20 6e 61 6d 65 20 69 73 20 22 3c  table name is "<
24a0: 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c  b>sqlite_master<
24b0: 2f 62 3e 22 20 77 68 69 63 68 0a 69 73 20 74 68  /b>" which.is th
24c0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61  e name of the ta
24d0: 62 6c 65 20 74 68 61 74 20 72 65 63 6f 72 64 73  ble that records
24e0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63   the database sc
24f0: 68 65 6d 61 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45 61  hema.</p>..<p>Ea
2500: 63 68 20 63 6f 6c 75 6d 6e 20 64 65 66 69 6e 69  ch column defini
2510: 74 69 6f 6e 20 69 73 20 74 68 65 20 6e 61 6d 65  tion is the name
2520: 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 66   of the column f
2530: 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68 65 0a 64  ollowed by the.d
2540: 61 74 61 74 79 70 65 20 66 6f 72 20 74 68 61 74  atatype for that
2550: 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20 6f 6e   column, then on
2560: 65 20 6f 72 20 6d 6f 72 65 20 6f 70 74 69 6f 6e  e or more option
2570: 61 6c 20 63 6f 6c 75 6d 6e 20 63 6f 6e 73 74 72  al column constr
2580: 61 69 6e 74 73 2e 0a 54 68 65 20 64 61 74 61 74  aints..The datat
2590: 79 70 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75  ype for the colu
25a0: 6d 6e 20 69 73 20 28 75 73 75 61 6c 6c 79 29 20  mn is (usually) 
25b0: 69 67 6e 6f 72 65 64 20 61 6e 64 20 6d 61 79 20  ignored and may 
25c0: 62 65 20 6f 6d 69 74 74 65 64 2e 0a 41 6c 6c 20  be omitted..All 
25d0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 73  information is s
25e0: 74 6f 72 65 64 20 61 73 20 6e 75 6c 6c 2d 74 65  tored as null-te
25f0: 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67 73  rminated strings
2600: 2e 0a 54 68 65 20 55 4e 49 51 55 45 20 63 6f 6e  ..The UNIQUE con
2610: 73 74 72 61 69 6e 74 20 63 61 75 73 65 73 20 61  straint causes a
2620: 6e 20 69 6e 64 65 78 20 74 6f 20 62 65 20 63 72  n index to be cr
2630: 65 61 74 65 64 20 6f 6e 20 74 68 65 20 73 70 65  eated on the spe
2640: 63 69 66 69 65 64 0a 63 6f 6c 75 6d 6e 73 2e 20  cified.columns. 
2650: 20 54 68 69 73 20 69 6e 64 65 78 20 6d 75 73 74   This index must
2660: 20 63 6f 6e 74 61 69 6e 20 75 6e 69 71 75 65 20   contain unique 
2670: 6b 65 79 73 2e 0a 54 68 65 20 44 45 46 41 55 4c  keys..The DEFAUL
2680: 54 20 63 6f 6e 73 74 72 61 69 6e 74 0a 73 70 65  T constraint.spe
2690: 63 69 66 69 65 73 20 61 20 64 65 66 61 75 6c 74  cifies a default
26a0: 20 76 61 6c 75 65 20 74 6f 20 75 73 65 20 77 68   value to use wh
26b0: 65 6e 20 64 6f 69 6e 67 20 61 6e 20 49 4e 53 45  en doing an INSE
26c0: 52 54 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 53 70 65  RT..</p>..<p>Spe
26d0: 63 69 66 79 69 6e 67 20 61 20 50 52 49 4d 41 52  cifying a PRIMAR
26e0: 59 20 4b 45 59 20 6e 6f 72 6d 61 6c 6c 79 20 6a  Y KEY normally j
26f0: 75 73 74 20 63 72 65 61 74 65 73 20 61 20 55 4e  ust creates a UN
2700: 49 51 55 45 20 69 6e 64 65 78 0a 6f 6e 20 74 68  IQUE index.on th
2710: 65 20 70 72 69 6d 61 72 79 20 6b 65 79 2e 20 20  e primary key.  
2720: 48 6f 77 65 76 65 72 2c 20 69 66 20 70 72 69 6d  However, if prim
2730: 61 72 79 20 6b 65 79 20 69 73 20 6f 6e 20 61 20  ary key is on a 
2740: 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 0a 74 68  single column.th
2750: 61 74 20 68 61 73 20 64 61 74 61 74 79 70 65 20  at has datatype 
2760: 49 4e 54 45 47 45 52 2c 20 74 68 65 6e 20 74 68  INTEGER, then th
2770: 61 74 20 63 6f 6c 75 6d 6e 20 69 73 20 75 73 65  at column is use
2780: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 61 73 20  d internally.as 
2790: 74 68 65 20 61 63 74 75 61 6c 20 6b 65 79 20 6f  the actual key o
27a0: 66 20 74 68 65 20 42 2d 54 72 65 65 20 66 6f 72  f the B-Tree for
27b0: 20 74 68 65 20 74 61 62 6c 65 2e 20 20 54 68 69   the table.  Thi
27c0: 73 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65  s means that the
27d0: 20 63 6f 6c 75 6d 6e 0a 6d 61 79 20 6f 6e 6c 79   column.may only
27e0: 20 68 6f 6c 64 20 75 6e 69 71 75 65 20 69 6e 74   hold unique int
27f0: 65 67 65 72 20 76 61 6c 75 65 73 2e 20 20 28 45  eger values.  (E
2800: 78 63 65 70 74 20 66 6f 72 20 74 68 69 73 20 6f  xcept for this o
2810: 6e 65 20 63 61 73 65 2c 0a 53 51 4c 69 74 65 20  ne case,.SQLite 
2820: 69 67 6e 6f 72 65 73 20 74 68 65 20 64 61 74 61  ignores the data
2830: 74 79 70 65 20 73 70 65 63 69 66 69 63 61 74 69  type specificati
2840: 6f 6e 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 61 6e  on of columns an
2850: 64 20 61 6c 6c 6f 77 73 0a 61 6e 79 20 6b 69 6e  d allows.any kin
2860: 64 20 6f 66 20 64 61 74 61 20 74 6f 20 62 65 20  d of data to be 
2870: 70 75 74 20 69 6e 20 61 20 63 6f 6c 75 6d 6e 20  put in a column 
2880: 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 69 74  regardless of it
2890: 73 20 64 65 63 6c 61 72 65 64 0a 64 61 74 61 74  s declared.datat
28a0: 79 70 65 2e 29 20 20 49 66 20 61 20 74 61 62 6c  ype.)  If a tabl
28b0: 65 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20  e does not have 
28c0: 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41  an INTEGER PRIMA
28d0: 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 2c 0a 74  RY KEY column,.t
28e0: 68 65 6e 20 74 68 65 20 42 2d 54 72 65 65 20 6b  hen the B-Tree k
28f0: 65 79 20 77 69 6c 6c 20 62 65 20 61 20 61 75 74  ey will be a aut
2900: 6f 6d 61 74 69 63 61 6c 6c 79 20 67 65 6e 65 72  omatically gener
2910: 61 74 65 64 20 69 6e 74 65 67 65 72 2e 20 20 54  ated integer.  T
2920: 68 65 0a 42 2d 54 72 65 65 20 6b 65 79 20 66 6f  he.B-Tree key fo
2930: 72 20 61 20 72 6f 77 20 63 61 6e 20 61 6c 77 61  r a row can alwa
2940: 79 73 20 62 65 20 61 63 63 65 73 73 65 64 20 75  ys be accessed u
2950: 73 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 0a  sing one of the.
2960: 73 70 65 63 69 61 6c 20 6e 61 6d 65 73 20 22 3c  special names "<
2970: 62 3e 52 4f 57 49 44 3c 2f 62 3e 22 2c 20 22 3c  b>ROWID</b>", "<
2980: 62 3e 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20 22  b>OID</b>", or "
2990: 3c 62 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22 2e  <b>_ROWID_</b>".
29a0: 0a 54 68 69 73 20 69 73 20 74 72 75 65 20 72 65  .This is true re
29b0: 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74  gardless of whet
29c0: 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 72 65  her or not there
29d0: 20 69 73 20 61 6e 20 49 4e 54 45 47 45 52 0a 50   is an INTEGER.P
29e0: 52 49 4d 41 52 59 20 4b 45 59 2e 3c 2f 70 3e 0a  RIMARY KEY.</p>.
29f0: 0a 3c 70 3e 49 66 20 74 68 65 20 22 54 45 4d 50  .<p>If the "TEMP
2a00: 22 20 6f 72 20 22 54 45 4d 50 4f 52 41 52 59 22  " or "TEMPORARY"
2a10: 20 6b 65 79 77 6f 72 64 20 6f 63 63 75 72 73 20   keyword occurs 
2a20: 69 6e 20 62 65 74 77 65 65 6e 20 22 43 52 45 41  in between "CREA
2a30: 54 45 22 0a 61 6e 64 20 22 54 41 42 4c 45 22 20  TE".and "TABLE" 
2a40: 74 68 65 6e 20 74 68 65 20 74 61 62 6c 65 20 74  then the table t
2a50: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 69  hat is created i
2a60: 73 20 6f 6e 6c 79 20 76 69 73 69 62 6c 65 20 74  s only visible t
2a70: 6f 20 74 68 65 0a 70 72 6f 63 65 73 73 20 74 68  o the.process th
2a80: 61 74 20 6f 70 65 6e 65 64 20 74 68 65 20 64 61  at opened the da
2a90: 74 61 62 61 73 65 20 61 6e 64 20 69 73 20 61 75  tabase and is au
2aa0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65  tomatically dele
2ab0: 74 65 64 20 77 68 65 6e 0a 74 68 65 20 64 61 74  ted when.the dat
2ac0: 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 2e  abase is closed.
2ad0: 20 20 41 6e 79 20 69 6e 64 69 63 65 73 20 63 72    Any indices cr
2ae0: 65 61 74 65 64 20 6f 6e 20 61 20 74 65 6d 70 6f  eated on a tempo
2af0: 72 61 72 79 20 74 61 62 6c 65 0a 61 72 65 20 61  rary table.are a
2b00: 6c 73 6f 20 74 65 6d 70 6f 72 61 72 79 2e 20 20  lso temporary.  
2b10: 54 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 73  Temporary tables
2b20: 20 61 6e 64 20 69 6e 64 69 63 65 73 20 61 72 65   and indices are
2b30: 20 73 74 6f 72 65 64 20 69 6e 20 61 0a 73 65 70   stored in a.sep
2b40: 61 72 61 74 65 20 66 69 6c 65 20 64 69 73 74 69  arate file disti
2b50: 6e 63 74 20 66 72 6f 6d 20 74 68 65 20 6d 61 69  nct from the mai
2b60: 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  n database file.
2b70: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74  </p>..<p>The opt
2b80: 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63  ional conflict-c
2b90: 6c 61 75 73 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  lause following 
2ba0: 65 61 63 68 20 63 6f 6e 73 74 72 61 69 6e 74 0a  each constraint.
2bb0: 61 6c 6c 6f 77 73 20 74 68 65 20 73 70 65 63 69  allows the speci
2bc0: 66 69 63 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61  fication of an a
2bd0: 6c 74 65 72 6e 61 74 69 76 65 20 64 65 66 61 75  lternative defau
2be0: 6c 74 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f  lt.constraint co
2bf0: 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f  nflict resolutio
2c00: 6e 20 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20  n algorithm for 
2c10: 74 68 61 74 20 63 6f 6e 73 74 72 61 69 6e 74 2e  that constraint.
2c20: 0a 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20  .The default is 
2c30: 61 62 6f 72 74 20 41 42 4f 52 54 2e 20 20 44 69  abort ABORT.  Di
2c40: 66 66 65 72 65 6e 74 20 63 6f 6e 73 74 72 61 69  fferent constrai
2c50: 6e 74 73 20 77 69 74 68 69 6e 20 74 68 65 20 73  nts within the s
2c60: 61 6d 65 0a 74 61 62 6c 65 20 6d 61 79 20 68 61  ame.table may ha
2c70: 76 65 20 64 69 66 66 65 72 65 6e 74 20 64 65 66  ve different def
2c80: 61 75 6c 74 20 63 6f 6e 66 6c 69 63 74 20 72 65  ault conflict re
2c90: 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74  solution algorit
2ca0: 68 6d 73 2e 0a 49 66 20 61 6e 20 43 4f 50 59 2c  hms..If an COPY,
2cb0: 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41   INSERT, or UPDA
2cc0: 54 45 20 63 6f 6d 6d 61 6e 64 20 73 70 65 63 69  TE command speci
2cd0: 66 69 65 73 20 61 20 64 69 66 66 65 72 65 6e 74  fies a different
2ce0: 20 63 6f 6e 66 6c 69 63 74 0a 72 65 73 6f 6c 75   conflict.resolu
2cf0: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2c 20  tion algorithm, 
2d00: 74 68 65 6e 20 74 68 61 74 20 61 6c 67 6f 72 69  then that algori
2d10: 74 68 6d 20 69 73 20 75 73 65 64 20 69 6e 20 70  thm is used in p
2d20: 6c 61 63 65 20 6f 66 20 74 68 65 0a 64 65 66 61  lace of the.defa
2d30: 75 6c 74 20 61 6c 67 6f 72 69 74 68 6d 20 73 70  ult algorithm sp
2d40: 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 43  ecified in the C
2d50: 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61 74  REATE TABLE stat
2d60: 65 6d 65 6e 74 2e 0a 53 65 65 20 74 68 65 20 73  ement..See the s
2d70: 65 63 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61  ection titled.<a
2d80: 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74   href="#conflict
2d90: 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61  ">ON CONFLICT</a
2da0: 3e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  > for additional
2db0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70   information.</p
2dc0: 3e 0a 0a 3c 70 3e 43 48 45 43 4b 20 63 6f 6e 73  >..<p>CHECK cons
2dd0: 74 72 61 69 6e 74 73 20 61 72 65 20 69 67 6e 6f  traints are igno
2de0: 72 65 64 20 69 6e 20 74 68 65 20 63 75 72 72 65  red in the curre
2df0: 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  nt implementatio
2e00: 6e 2e 0a 53 75 70 70 6f 72 74 20 66 6f 72 20 43  n..Support for C
2e10: 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73  HECK constraints
2e20: 20 6d 61 79 20 62 65 20 61 64 64 65 64 20 69 6e   may be added in
2e30: 20 74 68 65 20 66 75 74 75 72 65 2e 20 20 41 73   the future.  As
2e40: 20 6f 66 0a 76 65 72 73 69 6f 6e 20 32 2e 33 2e   of.version 2.3.
2e50: 30 2c 20 4e 4f 54 20 4e 55 4c 4c 2c 20 50 52 49  0, NOT NULL, PRI
2e60: 4d 41 52 59 20 4b 45 59 2c 20 61 6e 64 20 55 4e  MARY KEY, and UN
2e70: 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 73  IQUE constraints
2e80: 20 61 6c 6c 0a 77 6f 72 6b 2e 3c 2f 70 3e 0a 0a   all.work.</p>..
2e90: 3c 70 3e 54 68 65 72 65 20 61 72 65 20 6e 6f 20  <p>There are no 
2ea0: 61 72 62 69 74 72 61 72 79 20 6c 69 6d 69 74 73  arbitrary limits
2eb0: 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 0a 6f   on the number.o
2ec0: 66 20 63 6f 6c 75 6d 6e 73 20 6f 72 20 6f 6e 20  f columns or on 
2ed0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  the number of co
2ee0: 6e 73 74 72 61 69 6e 74 73 20 69 6e 20 61 20 74  nstraints in a t
2ef0: 61 62 6c 65 2e 0a 54 68 65 20 74 6f 74 61 6c 20  able..The total 
2f00: 61 6d 6f 75 6e 74 20 6f 66 20 64 61 74 61 20 69  amount of data i
2f10: 6e 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 69  n a single row i
2f20: 73 20 6c 69 6d 69 74 65 64 20 74 6f 20 61 62 6f  s limited to abo
2f30: 75 74 0a 31 20 6d 65 67 61 62 79 74 65 73 2e 20  ut.1 megabytes. 
2f40: 20 28 54 68 69 73 20 6c 69 6d 69 74 20 63 61 6e   (This limit can
2f50: 20 62 65 20 69 6e 63 72 65 61 73 65 64 20 74 6f   be increased to
2f60: 20 31 36 4d 42 20 62 79 20 63 68 61 6e 67 69 6e   16MB by changin
2f70: 67 0a 61 20 73 69 6e 67 6c 65 20 23 64 65 66 69  g.a single #defi
2f80: 6e 65 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65  ne in the source
2f90: 20 63 6f 64 65 20 61 6e 64 20 72 65 63 6f 6d 70   code and recomp
2fa0: 69 6c 69 6e 67 2e 29 3c 2f 70 3e 0a 0a 3c 70 3e  iling.)</p>..<p>
2fb0: 54 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  The CREATE TABLE
2fc0: 20 41 53 20 66 6f 72 6d 20 64 65 66 69 6e 65 73   AS form defines
2fd0: 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 62 65   the table to be
2fe0: 0a 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20  .the result set 
2ff0: 6f 66 20 61 20 71 75 65 72 79 2e 20 20 54 68 65  of a query.  The
3000: 20 6e 61 6d 65 73 20 6f 66 20 74 68 65 20 74 61   names of the ta
3010: 62 6c 65 20 63 6f 6c 75 6d 6e 73 20 61 72 65 0a  ble columns are.
3020: 74 68 65 20 6e 61 6d 65 73 20 6f 66 20 74 68 65  the names of the
3030: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
3040: 72 65 73 75 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e  result.</p>..<p>
3050: 54 68 65 20 65 78 61 63 74 20 74 65 78 74 0a 6f  The exact text.o
3060: 66 20 65 61 63 68 20 43 52 45 41 54 45 20 54 41  f each CREATE TA
3070: 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 20 69 73  BLE statement is
3080: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 3c   stored in the <
3090: 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c  b>sqlite_master<
30a0: 2f 62 3e 0a 74 61 62 6c 65 2e 20 20 45 76 65 72  /b>.table.  Ever
30b0: 79 74 69 6d 65 20 74 68 65 20 64 61 74 61 62 61  ytime the databa
30c0: 73 65 20 69 73 20 6f 70 65 6e 65 64 2c 20 61 6c  se is opened, al
30d0: 6c 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73  l CREATE TABLE s
30e0: 74 61 74 65 6d 65 6e 74 73 0a 61 72 65 20 72 65  tatements.are re
30f0: 61 64 20 66 72 6f 6d 20 74 68 65 20 3c 62 3e 73  ad from the <b>s
3100: 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e  qlite_master</b>
3110: 20 74 61 62 6c 65 20 61 6e 64 20 75 73 65 64 20   table and used 
3120: 74 6f 20 72 65 67 65 6e 65 72 61 74 65 0a 53 51  to regenerate.SQ
3130: 4c 69 74 65 27 73 20 69 6e 74 65 72 6e 61 6c 20  Lite's internal 
3140: 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f  representation o
3150: 66 20 74 68 65 20 74 61 62 6c 65 20 6c 61 79 6f  f the table layo
3160: 75 74 2e 0a 49 66 20 74 68 65 20 6f 72 69 67 69  ut..If the origi
3170: 6e 61 6c 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20  nal command was 
3180: 61 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 41  a CREATE TABLE A
3190: 53 20 74 68 65 6e 20 74 68 65 6e 20 61 6e 20 65  S then then an e
31a0: 71 75 69 76 61 6c 65 6e 74 0a 43 52 45 41 54 45  quivalent.CREATE
31b0: 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74   TABLE statement
31c0: 20 69 73 20 73 79 6e 74 68 65 73 69 7a 65 64 20   is synthesized 
31d0: 61 6e 64 20 73 74 6f 72 65 20 69 6e 20 3c 62 3e  and store in <b>
31e0: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 3c 2f 62  sqlite_master</b
31f0: 3e 0a 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 68  >.in place of th
3200: 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6d 6d 61  e original comma
3210: 6e 64 2e 0a 3c 2f 70 3e 0a 7d 0a 53 65 63 74 69  nd..</p>.}.Secti
3220: 6f 6e 20 7b 43 52 45 41 54 45 20 54 52 49 47 47  on {CREATE TRIGG
3230: 45 52 7d 20 63 72 65 61 74 65 74 72 69 67 67 65  ER} createtrigge
3240: 72 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  r..Syntax {sql-s
3250: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41  tatement} {.CREA
3260: 54 45 20 54 52 49 47 47 45 52 20 3c 74 72 69 67  TE TRIGGER <trig
3270: 67 65 72 2d 6e 61 6d 65 3e 20 5b 20 42 45 46 4f  ger-name> [ BEFO
3280: 52 45 20 7c 20 41 46 54 45 52 20 5d 0a 3c 64 61  RE | AFTER ].<da
3290: 74 61 62 61 73 65 2d 65 76 65 6e 74 3e 20 4f 4e  tabase-event> ON
32a0: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 0a 3c 74   <table-name>.<t
32b0: 72 69 67 67 65 72 2d 61 63 74 69 6f 6e 3e 0a 7d  rigger-action>.}
32c0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
32d0: 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41 54  atement} {.CREAT
32e0: 45 20 54 52 49 47 47 45 52 20 3c 74 72 69 67 67  E TRIGGER <trigg
32f0: 65 72 2d 6e 61 6d 65 3e 20 49 4e 53 54 45 41 44  er-name> INSTEAD
3300: 20 4f 46 0a 3c 64 61 74 61 62 61 73 65 2d 65 76   OF.<database-ev
3310: 65 6e 74 3e 20 4f 4e 20 3c 76 69 65 77 2d 6e 61  ent> ON <view-na
3320: 6d 65 3e 0a 3c 74 72 69 67 67 65 72 2d 61 63 74  me>.<trigger-act
3330: 69 6f 6e 3e 0a 7d 0a 0a 53 79 6e 74 61 78 20 7b  ion>.}..Syntax {
3340: 64 61 74 61 62 61 73 65 2d 65 76 65 6e 74 7d 20  database-event} 
3350: 7b 0a 44 45 4c 45 54 45 20 7c 20 0a 49 4e 53 45  {.DELETE | .INSE
3360: 52 54 20 7c 20 0a 55 50 44 41 54 45 20 7c 20 0a  RT | .UPDATE | .
3370: 55 50 44 41 54 45 20 4f 46 20 3c 63 6f 6c 75 6d  UPDATE OF <colum
3380: 6e 2d 6c 69 73 74 3e 0a 7d 0a 0a 53 79 6e 74 61  n-list>.}..Synta
3390: 78 20 7b 74 72 69 67 67 65 72 2d 61 63 74 69 6f  x {trigger-actio
33a0: 6e 7d 20 7b 0a 5b 20 46 4f 52 20 45 41 43 48 20  n} {.[ FOR EACH 
33b0: 52 4f 57 20 5d 20 5b 20 57 48 45 4e 20 3c 65 78  ROW ] [ WHEN <ex
33c0: 70 72 65 73 73 69 6f 6e 3e 20 5d 20 0a 42 45 47  pression> ] .BEG
33d0: 49 4e 20 0a 20 20 3c 74 72 69 67 67 65 72 2d 73  IN .  <trigger-s
33e0: 74 65 70 3e 20 3b 20 5b 20 3c 74 72 69 67 67 65  tep> ; [ <trigge
33f0: 72 2d 73 74 65 70 3e 20 3b 20 5d 2a 0a 45 4e 44  r-step> ; ]*.END
3400: 0a 7d 0a 0a 53 79 6e 74 61 78 20 7b 74 72 69 67  .}..Syntax {trig
3410: 67 65 72 2d 73 74 65 70 7d 20 7b 0a 3c 75 70 64  ger-step} {.<upd
3420: 61 74 65 2d 73 74 61 74 65 6d 65 6e 74 3e 20 7c  ate-statement> |
3430: 20 3c 69 6e 73 65 72 74 2d 73 74 61 74 65 6d 65   <insert-stateme
3440: 6e 74 3e 20 7c 20 0a 3c 64 65 6c 65 74 65 2d 73  nt> | .<delete-s
3450: 74 61 74 65 6d 65 6e 74 3e 20 7c 20 3c 73 65 6c  tatement> | <sel
3460: 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 20 0a  ect-statement> .
3470: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
3480: 20 43 52 45 41 54 45 20 54 52 49 47 47 45 52 20   CREATE TRIGGER 
3490: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 75 73 65  statement is use
34a0: 64 20 74 6f 20 61 64 64 20 74 72 69 67 67 65 72  d to add trigger
34b0: 73 20 74 6f 20 74 68 65 20 0a 64 61 74 61 62 61  s to the .databa
34c0: 73 65 20 73 63 68 65 6d 61 2e 20 54 72 69 67 67  se schema. Trigg
34d0: 65 72 73 20 61 72 65 20 64 61 74 61 62 61 73 65  ers are database
34e0: 20 6f 70 65 72 61 74 69 6f 6e 73 20 28 74 68 65   operations (the
34f0: 20 3c 69 3e 74 72 69 67 67 65 72 2d 61 63 74 69   <i>trigger-acti
3500: 6f 6e 3c 2f 69 3e 29 20 0a 74 68 61 74 20 61 72  on</i>) .that ar
3510: 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  e automatically 
3520: 70 65 72 66 6f 72 6d 65 64 20 77 68 65 6e 20 61  performed when a
3530: 20 73 70 65 63 69 66 69 65 64 20 64 61 74 61 62   specified datab
3540: 61 73 65 20 65 76 65 6e 74 20 28 74 68 65 0a 3c  ase event (the.<
3550: 69 3e 64 61 74 61 62 61 73 65 2d 65 76 65 6e 74  i>database-event
3560: 3c 2f 69 3e 29 20 6f 63 63 75 72 73 2e 20 20 3c  </i>) occurs.  <
3570: 2f 70 3e 0a 0a 3c 70 3e 41 20 74 72 69 67 67 65  /p>..<p>A trigge
3580: 72 20 6d 61 79 20 62 65 20 73 70 65 63 69 66 69  r may be specifi
3590: 65 64 20 74 6f 20 66 69 72 65 20 77 68 65 6e 65  ed to fire whene
35a0: 76 65 72 20 61 20 44 45 4c 45 54 45 2c 20 49 4e  ver a DELETE, IN
35b0: 53 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 6f  SERT or UPDATE o
35c0: 66 20 61 0a 70 61 72 74 69 63 75 6c 61 72 20 64  f a.particular d
35d0: 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 6f 63  atabase table oc
35e0: 63 75 72 73 2c 20 6f 72 20 77 68 65 6e 65 76 65  curs, or wheneve
35f0: 72 20 61 6e 20 55 50 44 41 54 45 20 6f 66 20 6f  r an UPDATE of o
3600: 6e 65 20 6f 72 20 6d 6f 72 65 0a 73 70 65 63 69  ne or more.speci
3610: 66 69 65 64 20 63 6f 6c 75 6d 6e 73 20 6f 66 20  fied columns of 
3620: 61 20 74 61 62 6c 65 20 61 72 65 20 75 70 64 61  a table are upda
3630: 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 74 20  ted.</p>..<p>At 
3640: 74 68 69 73 20 74 69 6d 65 20 53 51 4c 69 74 65  this time SQLite
3650: 20 73 75 70 70 6f 72 74 73 20 6f 6e 6c 79 20 46   supports only F
3660: 4f 52 20 45 41 43 48 20 52 4f 57 20 74 72 69 67  OR EACH ROW trig
3670: 67 65 72 73 2c 20 6e 6f 74 20 46 4f 52 20 45 41  gers, not FOR EA
3680: 43 48 0a 53 54 41 54 45 4d 45 4e 54 20 74 72 69  CH.STATEMENT tri
3690: 67 67 65 72 73 2e 20 48 65 6e 63 65 20 65 78 70  ggers. Hence exp
36a0: 6c 69 63 69 74 6c 79 20 73 70 65 63 69 66 79 69  licitly specifyi
36b0: 6e 67 20 46 4f 52 20 45 41 43 48 20 52 4f 57 20  ng FOR EACH ROW 
36c0: 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 46 4f  is optional.  FO
36d0: 52 0a 45 41 43 48 20 52 4f 57 20 69 6d 70 6c 69  R.EACH ROW impli
36e0: 65 73 20 74 68 61 74 20 74 68 65 20 53 51 4c 20  es that the SQL 
36f0: 73 74 61 74 65 6d 65 6e 74 73 20 73 70 65 63 69  statements speci
3700: 66 69 65 64 20 61 73 20 3c 69 3e 74 72 69 67 67  fied as <i>trigg
3710: 65 72 2d 73 74 65 70 73 3c 2f 69 3e 20 0a 6d 61  er-steps</i> .ma
3720: 79 20 62 65 20 65 78 65 63 75 74 65 64 20 28 64  y be executed (d
3730: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20  epending on the 
3740: 57 48 45 4e 20 63 6c 61 75 73 65 29 20 66 6f 72  WHEN clause) for
3750: 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20 72   each database r
3760: 6f 77 20 62 65 69 6e 67 0a 69 6e 73 65 72 74 65  ow being.inserte
3770: 64 2c 20 75 70 64 61 74 65 64 20 6f 72 20 64 65  d, updated or de
3780: 6c 65 74 65 64 20 62 79 20 74 68 65 20 73 74 61  leted by the sta
3790: 74 65 6d 65 6e 74 20 63 61 75 73 69 6e 67 20 74  tement causing t
37a0: 68 65 20 74 72 69 67 67 65 72 20 74 6f 20 66 69  he trigger to fi
37b0: 72 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 42 6f 74 68  re.</p>..<p>Both
37c0: 20 74 68 65 20 57 48 45 4e 20 63 6c 61 75 73 65   the WHEN clause
37d0: 20 61 6e 64 20 74 68 65 20 3c 69 3e 74 72 69 67   and the <i>trig
37e0: 67 65 72 2d 73 74 65 70 73 3c 2f 69 3e 20 6d 61  ger-steps</i> ma
37f0: 79 20 61 63 63 65 73 73 20 65 6c 65 6d 65 6e 74  y access element
3800: 73 20 6f 66 20 0a 74 68 65 20 72 6f 77 20 62 65  s of .the row be
3810: 69 6e 67 20 69 6e 73 65 72 74 65 64 2c 20 64 65  ing inserted, de
3820: 6c 65 74 65 64 20 6f 72 20 75 70 64 61 74 65 64  leted or updated
3830: 20 75 73 69 6e 67 20 72 65 66 65 72 65 6e 63 65   using reference
3840: 73 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 0a 22  s of the form ."
3850: 4e 45 57 2e 3c 69 3e 63 6f 6c 75 6d 6e 2d 6e 61  NEW.<i>column-na
3860: 6d 65 3c 2f 69 3e 22 20 61 6e 64 20 22 4f 4c 44  me</i>" and "OLD
3870: 2e 3c 69 3e 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3c  .<i>column-name<
3880: 2f 69 3e 22 2c 20 77 68 65 72 65 0a 3c 69 3e 63  /i>", where.<i>c
3890: 6f 6c 75 6d 6e 2d 6e 61 6d 65 3c 2f 69 3e 20 69  olumn-name</i> i
38a0: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20  s the name of a 
38b0: 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 74 68 65 20  column from the 
38c0: 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 74  table that the t
38d0: 72 69 67 67 65 72 0a 69 73 20 61 73 73 6f 63 69  rigger.is associ
38e0: 61 74 65 64 20 77 69 74 68 2e 20 4f 4c 44 20 61  ated with. OLD a
38f0: 6e 64 20 4e 45 57 20 72 65 66 65 72 65 6e 63 65  nd NEW reference
3900: 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 75 73  s may only be us
3910: 65 64 20 69 6e 20 74 72 69 67 67 65 72 73 20 6f  ed in triggers o
3920: 6e 0a 3c 69 3e 74 72 69 67 67 65 72 2d 65 76 65  n.<i>trigger-eve
3930: 6e 74 3c 2f 69 3e 73 20 66 6f 72 20 77 68 69 63  nt</i>s for whic
3940: 68 20 74 68 65 79 20 61 72 65 20 72 65 6c 65 76  h they are relev
3950: 61 6e 74 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a  ant, as follows:
3960: 3c 2f 70 3e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72  </p>..<table bor
3970: 64 65 72 3d 30 20 63 65 6c 6c 70 61 64 64 69 6e  der=0 cellpaddin
3980: 67 3d 31 30 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76  g=10>.<tr>.<td v
3990: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67  align="top" alig
39a0: 6e 3d 22 72 69 67 68 74 22 20 77 69 64 74 68 3d  n="right" width=
39b0: 31 32 30 3e 3c 69 3e 49 4e 53 45 52 54 3c 2f 69  120><i>INSERT</i
39c0: 3e 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67  ></td>.<td valig
39d0: 6e 3d 22 74 6f 70 22 3e 4e 45 57 20 72 65 66 65  n="top">NEW refe
39e0: 72 65 6e 63 65 73 20 61 72 65 20 76 61 6c 69 64  rences are valid
39f0: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e  </td>.</tr>.<tr>
3a00: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
3a10: 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 20  " align="right" 
3a20: 77 69 64 74 68 3d 31 32 30 3e 3c 69 3e 55 50 44  width=120><i>UPD
3a30: 41 54 45 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c 74 64  ATE</i></td>.<td
3a40: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 4e 45   valign="top">NE
3a50: 57 20 61 6e 64 20 4f 4c 44 20 72 65 66 65 72 65  W and OLD refere
3a60: 6e 63 65 73 20 61 72 65 20 76 61 6c 69 64 3c 2f  nces are valid</
3a70: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c  td>.</tr>.<tr>.<
3a80: 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20  td valign="top" 
3a90: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 20 77 69  align="right" wi
3aa0: 64 74 68 3d 31 32 30 3e 3c 69 3e 44 45 4c 45 54  dth=120><i>DELET
3ab0: 45 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c 74 64 20 76  E</i></td>.<td v
3ac0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 4f 4c 44 20  align="top">OLD 
3ad0: 72 65 66 65 72 65 6e 63 65 73 20 61 72 65 20 76  references are v
3ae0: 61 6c 69 64 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a  alid</td>.</tr>.
3af0: 3c 2f 74 61 62 6c 65 3e 0a 3c 2f 70 3e 0a 0a 3c  </table>.</p>..<
3b00: 70 3e 49 66 20 61 20 57 48 45 4e 20 63 6c 61 75  p>If a WHEN clau
3b10: 73 65 20 69 73 20 73 75 70 70 6c 69 65 64 2c 20  se is supplied, 
3b20: 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  the SQL statemen
3b30: 74 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20  ts specified as 
3b40: 3c 69 3e 74 72 69 67 67 65 72 2d 73 74 65 70 73  <i>trigger-steps
3b50: 3c 2f 69 3e 20 61 72 65 20 6f 6e 6c 79 20 65 78  </i> are only ex
3b60: 65 63 75 74 65 64 20 66 6f 72 20 72 6f 77 73 20  ecuted for rows 
3b70: 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 57 48  for which the WH
3b80: 45 4e 20 63 6c 61 75 73 65 20 69 73 20 74 72 75  EN clause is tru
3b90: 65 2e 20 49 66 20 6e 6f 20 57 48 45 4e 20 63 6c  e. If no WHEN cl
3ba0: 61 75 73 65 20 69 73 20 73 75 70 70 6c 69 65 64  ause is supplied
3bb0: 2c 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d  , the SQL statem
3bc0: 65 6e 74 73 20 61 72 65 20 65 78 65 63 75 74 65  ents are execute
3bd0: 64 20 66 6f 72 20 61 6c 6c 20 72 6f 77 73 2e 3c  d for all rows.<
3be0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 73 70 65 63  /p>..<p>The spec
3bf0: 69 66 69 65 64 20 3c 69 3e 74 72 69 67 67 65 72  ified <i>trigger
3c00: 2d 74 69 6d 65 3c 2f 69 3e 20 64 65 74 65 72 6d  -time</i> determ
3c10: 69 6e 65 73 20 77 68 65 6e 20 74 68 65 20 3c 69  ines when the <i
3c20: 3e 74 72 69 67 67 65 72 2d 73 74 65 70 73 3c 2f  >trigger-steps</
3c30: 69 3e 0a 77 69 6c 6c 20 62 65 20 65 78 65 63 75  i>.will be execu
3c40: 74 65 64 20 72 65 6c 61 74 69 76 65 20 74 6f 20  ted relative to 
3c50: 74 68 65 20 69 6e 73 65 72 74 69 6f 6e 2c 20 6d  the insertion, m
3c60: 6f 64 69 66 69 63 61 74 69 6f 6e 20 6f 72 20 72  odification or r
3c70: 65 6d 6f 76 61 6c 20 6f 66 20 74 68 65 0a 61 73  emoval of the.as
3c80: 73 6f 63 69 61 74 65 64 20 72 6f 77 2e 3c 2f 70  sociated row.</p
3c90: 3e 0a 0a 3c 70 3e 41 6e 20 4f 4e 20 43 4f 4e 46  >..<p>An ON CONF
3ca0: 4c 49 43 54 20 63 6c 61 75 73 65 20 6d 61 79 20  LICT clause may 
3cb0: 62 65 20 73 70 65 63 69 66 69 65 64 20 61 73 20  be specified as 
3cc0: 70 61 72 74 20 6f 66 20 61 6e 20 55 50 44 41 54  part of an UPDAT
3cd0: 45 20 6f 72 20 49 4e 53 45 52 54 0a 3c 69 3e 74  E or INSERT.<i>t
3ce0: 72 69 67 67 65 72 2d 73 74 65 70 3c 2f 69 3e 2e  rigger-step</i>.
3cf0: 20 48 6f 77 65 76 65 72 20 69 66 20 61 6e 20 4f   However if an O
3d00: 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73  N CONFLICT claus
3d10: 65 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61  e is specified a
3d20: 73 20 70 61 72 74 20 6f 66 20 0a 74 68 65 20 73  s part of .the s
3d30: 74 61 74 65 6d 65 6e 74 20 63 61 75 73 69 6e 67  tatement causing
3d40: 20 74 68 65 20 74 72 69 67 67 65 72 20 74 6f 20   the trigger to 
3d50: 66 69 72 65 2c 20 74 68 65 6e 20 74 68 69 73 20  fire, then this 
3d60: 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 69 6e  conflict handlin
3d70: 67 0a 70 6f 6c 69 63 79 20 69 73 20 75 73 65 64  g.policy is used
3d80: 20 69 6e 73 74 65 61 64 2e 3c 2f 70 3e 0a 0a 3c   instead.</p>..<
3d90: 70 3e 54 72 69 67 67 65 72 73 20 61 72 65 20 61  p>Triggers are a
3da0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 72 6f  utomatically dro
3db0: 70 70 65 64 20 77 68 65 6e 20 74 68 65 20 74 61  pped when the ta
3dc0: 62 6c 65 20 74 68 61 74 20 74 68 65 79 20 61 72  ble that they ar
3dd0: 65 20 0a 61 73 73 6f 63 69 61 74 65 64 20 77 69  e .associated wi
3de0: 74 68 20 69 73 20 64 72 6f 70 70 65 64 2e 3c 2f  th is dropped.</
3df0: 70 3e 0a 0a 3c 70 3e 54 72 69 67 67 65 72 73 20  p>..<p>Triggers 
3e00: 6d 61 79 20 62 65 20 63 72 65 61 74 65 64 20 6f  may be created o
3e10: 6e 20 76 69 65 77 73 2c 20 61 73 20 77 65 6c 6c  n views, as well
3e20: 20 61 73 20 6f 72 64 69 6e 61 72 79 20 74 61 62   as ordinary tab
3e30: 6c 65 73 2c 20 62 79 20 73 70 65 63 69 66 79 69  les, by specifyi
3e40: 6e 67 0a 49 4e 53 54 45 41 44 20 4f 46 20 69 6e  ng.INSTEAD OF in
3e50: 20 74 68 65 20 43 52 45 41 54 45 20 54 52 49 47   the CREATE TRIG
3e60: 47 45 52 20 73 74 61 74 65 6d 65 6e 74 2e 20 49  GER statement. I
3e70: 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 4f 4e  f one or more ON
3e80: 20 49 4e 53 45 52 54 2c 20 4f 4e 20 44 45 4c 45   INSERT, ON DELE
3e90: 54 45 0a 6f 72 20 4f 4e 20 55 50 44 41 54 45 20  TE.or ON UPDATE 
3ea0: 74 72 69 67 67 65 72 73 20 61 72 65 20 64 65 66  triggers are def
3eb0: 69 6e 65 64 20 6f 6e 20 61 20 76 69 65 77 2c 20  ined on a view, 
3ec0: 74 68 65 6e 20 69 74 20 69 73 20 6e 6f 74 20 61  then it is not a
3ed0: 6e 20 65 72 72 6f 72 20 74 6f 20 65 78 65 63 75  n error to execu
3ee0: 74 65 0a 61 6e 20 49 4e 53 45 52 54 2c 20 44 45  te.an INSERT, DE
3ef0: 4c 45 54 45 20 6f 72 20 55 50 44 41 54 45 20 73  LETE or UPDATE s
3f00: 74 61 74 65 6d 65 6e 74 20 6f 6e 20 74 68 65 20  tatement on the 
3f10: 76 69 65 77 2c 20 72 65 73 70 65 63 74 69 76 65  view, respective
3f20: 6c 79 2e 20 54 68 65 72 65 61 66 74 65 72 2c 0a  ly. Thereafter,.
3f30: 65 78 65 63 75 74 69 6e 67 20 61 6e 20 49 4e 53  executing an INS
3f40: 45 52 54 2c 20 44 45 4c 45 54 45 20 6f 72 20 55  ERT, DELETE or U
3f50: 50 44 41 54 45 20 6f 6e 20 74 68 65 20 76 69 65  PDATE on the vie
3f60: 77 20 63 61 75 73 65 73 20 74 68 65 20 61 73 73  w causes the ass
3f70: 6f 63 69 61 74 65 64 0a 20 20 74 72 69 67 67 65  ociated.  trigge
3f80: 72 73 20 74 6f 20 66 69 72 65 2e 20 54 68 65 20  rs to fire. The 
3f90: 72 65 61 6c 20 74 61 62 6c 65 73 20 75 6e 64 65  real tables unde
3fa0: 72 6c 79 69 6e 67 20 74 68 65 20 76 69 65 77 20  rlying the view 
3fb0: 61 72 65 20 6e 6f 74 20 6d 6f 64 69 66 69 65 64  are not modified
3fc0: 0a 20 20 28 65 78 63 65 70 74 20 70 6f 73 73 69  .  (except possi
3fd0: 62 6c 79 20 65 78 70 6c 69 63 69 74 6c 79 2c 20  bly explicitly, 
3fe0: 62 79 20 61 20 74 72 69 67 67 65 72 20 70 72 6f  by a trigger pro
3ff0: 67 72 61 6d 29 2e 3c 2f 70 3e 0a 0a 3c 70 3e 3c  gram).</p>..<p><
4000: 62 3e 45 78 61 6d 70 6c 65 3a 3c 2f 62 3e 3c 2f  b>Example:</b></
4010: 70 3e 0a 0a 3c 70 3e 41 73 73 75 6d 69 6e 67 20  p>..<p>Assuming 
4020: 74 68 61 74 20 63 75 73 74 6f 6d 65 72 20 72 65  that customer re
4030: 63 6f 72 64 73 20 61 72 65 20 73 74 6f 72 65 64  cords are stored
4040: 20 69 6e 20 74 68 65 20 22 63 75 73 74 6f 6d 65   in the "custome
4050: 72 73 22 20 74 61 62 6c 65 2c 20 61 6e 64 0a 74  rs" table, and.t
4060: 68 61 74 20 6f 72 64 65 72 20 72 65 63 6f 72 64  hat order record
4070: 73 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20  s are stored in 
4080: 74 68 65 20 22 6f 72 64 65 72 73 22 20 74 61 62  the "orders" tab
4090: 6c 65 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  le, the followin
40a0: 67 20 74 72 69 67 67 65 72 0a 65 6e 73 75 72 65  g trigger.ensure
40b0: 73 20 74 68 61 74 20 61 6c 6c 20 61 73 73 6f 63  s that all assoc
40c0: 69 61 74 65 64 20 6f 72 64 65 72 73 20 61 72 65  iated orders are
40d0: 20 72 65 64 69 72 65 63 74 65 64 20 77 68 65 6e   redirected when
40e0: 20 61 20 63 75 73 74 6f 6d 65 72 20 63 68 61 6e   a customer chan
40f0: 67 65 73 0a 68 69 73 20 6f 72 20 68 65 72 20 61  ges.his or her a
4100: 64 64 72 65 73 73 3a 3c 2f 70 3e 0a 7d 0a 45 78  ddress:</p>.}.Ex
4110: 61 6d 70 6c 65 20 7b 0a 43 52 45 41 54 45 20 54  ample {.CREATE T
4120: 52 49 47 47 45 52 20 75 70 64 61 74 65 5f 63 75  RIGGER update_cu
4130: 73 74 6f 6d 65 72 5f 61 64 64 72 65 73 73 20 55  stomer_address U
4140: 50 44 41 54 45 20 4f 46 20 61 64 64 72 65 73 73  PDATE OF address
4150: 20 4f 4e 20 63 75 73 74 6f 6d 65 72 73 20 0a 20   ON customers . 
4160: 20 42 45 47 49 4e 0a 20 20 20 20 55 50 44 41 54   BEGIN.    UPDAT
4170: 45 20 6f 72 64 65 72 73 20 53 45 54 20 61 64 64  E orders SET add
4180: 72 65 73 73 20 3d 20 6e 65 77 2e 61 64 64 72 65  ress = new.addre
4190: 73 73 20 57 48 45 52 45 20 63 75 73 74 6f 6d 65  ss WHERE custome
41a0: 72 5f 6e 61 6d 65 20 3d 20 6f 6c 64 2e 6e 61 6d  r_name = old.nam
41b0: 65 3b 0a 20 20 45 4e 44 3b 0a 7d 0a 70 75 74 73  e;.  END;.}.puts
41c0: 20 7b 0a 3c 70 3e 57 69 74 68 20 74 68 69 73 20   {.<p>With this 
41d0: 74 72 69 67 67 65 72 20 69 6e 73 74 61 6c 6c 65  trigger installe
41e0: 64 2c 20 65 78 65 63 75 74 69 6e 67 20 74 68 65  d, executing the
41f0: 20 73 74 61 74 65 6d 65 6e 74 3a 3c 2f 70 3e 0a   statement:</p>.
4200: 7d 0a 0a 45 78 61 6d 70 6c 65 20 7b 0a 55 50 44  }..Example {.UPD
4210: 41 54 45 20 63 75 73 74 6f 6d 65 72 73 20 53 45  ATE customers SE
4220: 54 20 61 64 64 72 65 73 73 20 3d 20 27 31 20 4d  T address = '1 M
4230: 61 69 6e 20 53 74 2e 27 20 57 48 45 52 45 20 6e  ain St.' WHERE n
4240: 61 6d 65 20 3d 20 27 4a 61 63 6b 20 4a 6f 6e 65  ame = 'Jack Jone
4250: 73 27 3b 0a 7d 0a 70 75 74 73 20 7b 0a 3c 70 3e  s';.}.puts {.<p>
4260: 63 61 75 73 65 73 20 74 68 65 20 66 6f 6c 6c 6f  causes the follo
4270: 77 69 6e 67 20 74 6f 20 62 65 20 61 75 74 6f 6d  wing to be autom
4280: 61 74 69 63 61 6c 6c 79 20 65 78 65 63 75 74 65  atically execute
4290: 64 3a 3c 2f 70 3e 0a 7d 0a 45 78 61 6d 70 6c 65  d:</p>.}.Example
42a0: 20 7b 0a 55 50 44 41 54 45 20 6f 72 64 65 72 73   {.UPDATE orders
42b0: 20 53 45 54 20 61 64 64 72 65 73 73 20 3d 20 27   SET address = '
42c0: 31 20 4d 61 69 6e 20 53 74 2e 27 20 57 48 45 52  1 Main St.' WHER
42d0: 45 20 63 75 73 74 6f 6d 65 72 5f 6e 61 6d 65 20  E customer_name 
42e0: 3d 20 27 4a 61 63 6b 20 4a 6f 6e 65 73 27 3b 0a  = 'Jack Jones';.
42f0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 4e 6f 74  }..puts {.<p>Not
4300: 65 20 74 68 61 74 20 63 75 72 72 65 6e 74 6c 79  e that currently
4310: 2c 20 74 72 69 67 67 65 72 73 20 6d 61 79 20 62  , triggers may b
4320: 65 68 61 76 65 20 6f 64 64 6c 79 20 77 68 65 6e  ehave oddly when
4330: 20 63 72 65 61 74 65 64 20 6f 6e 20 74 61 62 6c   created on tabl
4340: 65 73 0a 20 20 77 69 74 68 20 49 4e 54 45 47 45  es.  with INTEGE
4350: 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 69  R PRIMARY KEY fi
4360: 65 6c 64 73 2e 20 49 66 20 61 20 42 45 46 4f 52  elds. If a BEFOR
4370: 45 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61  E trigger progra
4380: 6d 20 6d 6f 64 69 66 69 65 73 20 74 68 65 20 0a  m modifies the .
4390: 20 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52    INTEGER PRIMAR
43a0: 59 20 4b 45 59 20 66 69 65 6c 64 20 6f 66 20 61  Y KEY field of a
43b0: 20 72 6f 77 20 74 68 61 74 20 77 69 6c 6c 20 62   row that will b
43c0: 65 20 73 75 62 73 65 71 75 65 6e 74 6c 79 20 75  e subsequently u
43d0: 70 64 61 74 65 64 20 62 79 20 74 68 65 0a 20 20  pdated by the.  
43e0: 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20 63  statement that c
43f0: 61 75 73 65 73 20 74 68 65 20 74 72 69 67 67 65  auses the trigge
4400: 72 20 74 6f 20 66 69 72 65 2c 20 74 68 65 6e 20  r to fire, then 
4410: 74 68 65 20 75 70 64 61 74 65 20 6d 61 79 20 6e  the update may n
4420: 6f 74 20 6f 63 63 75 72 2e 20 0a 20 20 54 68 65  ot occur. .  The
4430: 20 77 6f 72 6b 61 72 6f 75 6e 64 20 69 73 20 74   workaround is t
4440: 6f 20 64 65 63 6c 61 72 65 20 74 68 65 20 74 61  o declare the ta
4450: 62 6c 65 20 77 69 74 68 20 61 20 50 52 49 4d 41  ble with a PRIMA
4460: 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 20 69 6e  RY KEY column in
4470: 73 74 65 61 64 0a 20 20 6f 66 20 61 6e 20 49 4e  stead.  of an IN
4480: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45  TEGER PRIMARY KE
4490: 59 20 63 6f 6c 75 6d 6e 2e 3c 2f 70 3e 0a 7d 0a  Y column.</p>.}.
44a0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 41 20 73 70 65  .puts {.<p>A spe
44b0: 63 69 61 6c 20 53 51 4c 20 66 75 6e 63 74 69 6f  cial SQL functio
44c0: 6e 20 52 41 49 53 45 28 29 20 6d 61 79 20 62 65  n RAISE() may be
44d0: 20 75 73 65 64 20 77 69 74 68 69 6e 20 61 20 74   used within a t
44e0: 72 69 67 67 65 72 2d 70 72 6f 67 72 61 6d 2c 20  rigger-program, 
44f0: 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69  with the followi
4500: 6e 67 20 73 79 6e 74 61 78 3c 2f 70 3e 20 0a 7d  ng syntax</p> .}
4510: 0a 53 79 6e 74 61 78 20 7b 72 61 69 73 65 2d 66  .Syntax {raise-f
4520: 75 6e 63 74 69 6f 6e 7d 20 7b 0a 52 41 49 53 45  unction} {.RAISE
4530: 20 28 20 41 42 4f 52 54 2c 20 3c 65 72 72 6f 72   ( ABORT, <error
4540: 2d 6d 65 73 73 61 67 65 3e 20 29 20 7c 20 0a 52  -message> ) | .R
4550: 41 49 53 45 20 28 20 46 41 49 4c 2c 20 3c 65 72  AISE ( FAIL, <er
4560: 72 6f 72 2d 6d 65 73 73 61 67 65 3e 20 29 20 7c  ror-message> ) |
4570: 20 0a 52 41 49 53 45 20 28 20 52 4f 4c 4c 42 41   .RAISE ( ROLLBA
4580: 43 4b 2c 20 3c 65 72 72 6f 72 2d 6d 65 73 73 61  CK, <error-messa
4590: 67 65 3e 20 29 20 7c 20 0a 52 41 49 53 45 20 28  ge> ) | .RAISE (
45a0: 20 49 47 4e 4f 52 45 20 29 0a 7d 0a 70 75 74 73   IGNORE ).}.puts
45b0: 20 7b 0a 3c 70 3e 57 68 65 6e 20 6f 6e 65 20 6f   {.<p>When one o
45c0: 66 20 74 68 65 20 66 69 72 73 74 20 74 68 72 65  f the first thre
45d0: 65 20 66 6f 72 6d 73 20 69 73 20 63 61 6c 6c 65  e forms is calle
45e0: 64 20 64 75 72 69 6e 67 20 74 72 69 67 67 65 72  d during trigger
45f0: 2d 70 72 6f 67 72 61 6d 20 65 78 65 63 75 74 69  -program executi
4600: 6f 6e 2c 20 74 68 65 20 73 70 65 63 69 66 69 65  on, the specifie
4610: 64 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 70 72  d ON CONFLICT pr
4620: 6f 63 65 73 73 69 6e 67 20 69 73 20 70 65 72 66  ocessing is perf
4630: 6f 72 6d 65 64 20 28 65 69 74 68 65 72 20 41 42  ormed (either AB
4640: 4f 52 54 2c 20 46 41 49 4c 20 6f 72 20 0a 20 52  ORT, FAIL or . R
4650: 4f 4c 4c 42 41 43 4b 29 20 61 6e 64 20 74 68 65  OLLBACK) and the
4660: 20 63 75 72 72 65 6e 74 20 71 75 65 72 79 20 74   current query t
4670: 65 72 6d 69 6e 61 74 65 73 2e 20 41 6e 20 65 72  erminates. An er
4680: 72 6f 72 20 63 6f 64 65 20 6f 66 20 53 51 4c 49  ror code of SQLI
4690: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 69 73  TE_CONSTRAINT is
46a0: 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65   returned to the
46b0: 20 75 73 65 72 2c 20 61 6c 6f 6e 67 20 77 69 74   user, along wit
46c0: 68 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20  h the specified 
46d0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 3c 2f  error message.</
46e0: 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 52 41 49 53  p>..<p>When RAIS
46f0: 45 28 49 47 4e 4f 52 45 29 20 69 73 20 63 61 6c  E(IGNORE) is cal
4700: 6c 65 64 2c 20 74 68 65 20 72 65 6d 61 69 6e 64  led, the remaind
4710: 65 72 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e  er of the curren
4720: 74 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61  t trigger progra
4730: 6d 2c 0a 74 68 65 20 73 74 61 74 65 6d 65 6e 74  m,.the statement
4740: 20 74 68 61 74 20 63 61 75 73 65 64 20 74 68 65   that caused the
4750: 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d   trigger program
4760: 20 74 6f 20 65 78 65 63 75 74 65 20 61 6e 64 20   to execute and 
4770: 61 6e 79 20 73 75 62 73 65 71 75 65 6e 74 0a 20  any subsequent. 
4780: 20 20 20 74 72 69 67 67 65 72 20 70 72 6f 67 72     trigger progr
4790: 61 6d 73 20 74 68 61 74 20 77 6f 75 6c 64 20 6f  ams that would o
47a0: 66 20 62 65 65 6e 20 65 78 65 63 75 74 65 64 20  f been executed 
47b0: 61 72 65 20 61 62 61 6e 64 6f 6e 65 64 2e 20 4e  are abandoned. N
47c0: 6f 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 63  o database.    c
47d0: 68 61 6e 67 65 73 20 61 72 65 20 72 6f 6c 6c 65  hanges are rolle
47e0: 64 20 62 61 63 6b 2e 20 20 49 66 20 74 68 65 20  d back.  If the 
47f0: 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20 63  statement that c
4800: 61 75 73 65 64 20 74 68 65 20 74 72 69 67 67 65  aused the trigge
4810: 72 20 70 72 6f 67 72 61 6d 0a 20 20 20 20 74 6f  r program.    to
4820: 20 65 78 65 63 75 74 65 20 69 73 20 69 74 73 65   execute is itse
4830: 6c 66 20 70 61 72 74 20 6f 66 20 61 20 74 72 69  lf part of a tri
4840: 67 67 65 72 20 70 72 6f 67 72 61 6d 2c 20 74 68  gger program, th
4850: 65 6e 20 74 68 61 74 20 74 72 69 67 67 65 72 20  en that trigger 
4860: 70 72 6f 67 72 61 6d 0a 20 20 20 20 72 65 73 75  program.    resu
4870: 6d 65 73 20 65 78 65 63 75 74 69 6f 6e 20 61 74  mes execution at
4880: 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f   the beginning o
4890: 66 20 74 68 65 20 6e 65 78 74 20 73 74 65 70 2e  f the next step.
48a0: 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
48b0: 20 7b 43 52 45 41 54 45 20 56 49 45 57 7d 20 7b   {CREATE VIEW} {
48c0: 63 72 65 61 74 65 76 69 65 77 7d 0a 0a 53 79 6e  createview}..Syn
48d0: 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64  tax {sql-command
48e0: 7d 20 7b 0a 43 52 45 41 54 45 20 56 49 45 57 20  } {.CREATE VIEW 
48f0: 3c 76 69 65 77 2d 6e 61 6d 65 3e 20 41 53 20 3c  <view-name> AS <
4900: 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74  select-statement
4910: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  >.}..puts {.<p>T
4920: 68 65 20 43 52 45 41 54 45 20 56 49 45 57 20 63  he CREATE VIEW c
4930: 6f 6d 6d 61 6e 64 20 61 73 73 69 67 6e 73 20 61  ommand assigns a
4940: 20 6e 61 6d 65 20 74 6f 20 61 20 70 72 65 2d 70   name to a pre-p
4950: 61 63 6b 61 67 65 64 20 53 45 4c 45 43 54 0a 73  ackaged SELECT.s
4960: 74 61 74 65 6d 65 6e 74 2e 20 20 4f 6e 63 65 20  tatement.  Once 
4970: 74 68 65 20 76 69 65 77 20 69 73 20 63 72 65 61  the view is crea
4980: 74 65 64 2c 20 69 74 20 63 61 6e 20 62 65 20 75  ted, it can be u
4990: 73 65 64 20 69 6e 20 74 68 65 20 46 52 4f 4d 20  sed in the FROM 
49a0: 63 6c 61 75 73 65 0a 6f 66 20 61 6e 6f 74 68 65  clause.of anothe
49b0: 72 20 53 45 4c 45 43 54 20 69 6e 20 70 6c 61 63  r SELECT in plac
49c0: 65 20 6f 66 20 61 20 74 61 62 6c 65 20 6e 61 6d  e of a table nam
49d0: 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 59 6f 75 20  e..</p>..<p>You 
49e0: 63 61 6e 6e 6f 74 20 43 4f 50 59 2c 20 49 4e 53  cannot COPY, INS
49f0: 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 61 20  ERT or UPDATE a 
4a00: 76 69 65 77 2e 20 20 56 69 65 77 73 20 61 72 65  view.  Views are
4a10: 20 72 65 61 64 2d 6f 6e 6c 79 2e 3c 2f 70 3e 0a   read-only.</p>.
4a20: 7d 0a 0a 53 65 63 74 69 6f 6e 20 44 45 4c 45 54  }..Section DELET
4a30: 45 20 64 65 6c 65 74 65 0a 0a 53 79 6e 74 61 78  E delete..Syntax
4a40: 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d   {sql-statement}
4a50: 20 7b 0a 44 45 4c 45 54 45 20 46 52 4f 4d 20 3c   {.DELETE FROM <
4a60: 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 57 48 45  table-name> [WHE
4a70: 52 45 20 3c 65 78 70 72 3e 5d 0a 7d 0a 0a 70 75  RE <expr>].}..pu
4a80: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 44 45 4c 45  ts {.<p>The DELE
4a90: 54 45 20 63 6f 6d 6d 61 6e 64 20 69 73 20 75 73  TE command is us
4aa0: 65 64 20 74 6f 20 72 65 6d 6f 76 65 20 72 65 63  ed to remove rec
4ab0: 6f 72 64 73 20 66 72 6f 6d 20 61 20 74 61 62 6c  ords from a tabl
4ac0: 65 2e 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 20 63  e..The command c
4ad0: 6f 6e 73 69 73 74 73 20 6f 66 20 74 68 65 20 22  onsists of the "
4ae0: 44 45 4c 45 54 45 20 46 52 4f 4d 22 20 6b 65 79  DELETE FROM" key
4af0: 77 6f 72 64 73 20 66 6f 6c 6c 6f 77 65 64 20 62  words followed b
4b00: 79 0a 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68  y.the name of th
4b10: 65 20 74 61 62 6c 65 20 66 72 6f 6d 20 77 68 69  e table from whi
4b20: 63 68 20 72 65 63 6f 72 64 73 20 61 72 65 20 74  ch records are t
4b30: 6f 20 62 65 20 72 65 6d 6f 76 65 64 2e 0a 3c 2f  o be removed..</
4b40: 70 3e 0a 0a 3c 70 3e 57 69 74 68 6f 75 74 20 61  p>..<p>Without a
4b50: 20 57 48 45 52 45 20 63 6c 61 75 73 65 2c 20 61   WHERE clause, a
4b60: 6c 6c 20 72 6f 77 73 20 6f 66 20 74 68 65 20 74  ll rows of the t
4b70: 61 62 6c 65 20 61 72 65 20 72 65 6d 6f 76 65 64  able are removed
4b80: 2e 0a 49 66 20 61 20 57 48 45 52 45 20 63 6c 61  ..If a WHERE cla
4b90: 75 73 65 20 69 73 20 73 75 70 70 6c 69 65 64 2c  use is supplied,
4ba0: 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 6f 73 65   then only those
4bb0: 20 72 6f 77 73 20 74 68 61 74 20 6d 61 74 63 68   rows that match
4bc0: 0a 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20  .the expression 
4bd0: 61 72 65 20 72 65 6d 6f 76 65 64 2e 3c 2f 70 3e  are removed.</p>
4be0: 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52  .}...Section {DR
4bf0: 4f 50 20 49 4e 44 45 58 7d 20 64 72 6f 70 69 6e  OP INDEX} dropin
4c00: 64 65 78 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  dex..Syntax {sql
4c10: 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50  -command} {.DROP
4c20: 20 49 4e 44 45 58 20 3c 69 6e 64 65 78 2d 6e 61   INDEX <index-na
4c30: 6d 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  me>.}..puts {.<p
4c40: 3e 54 68 65 20 44 52 4f 50 20 49 4e 44 45 58 20  >The DROP INDEX 
4c50: 73 74 61 74 65 6d 65 6e 74 20 63 6f 6e 73 69 73  statement consis
4c60: 74 73 20 6f 66 20 74 68 65 20 6b 65 79 77 6f 72  ts of the keywor
4c70: 64 73 20 22 44 52 4f 50 20 49 4e 44 45 58 22 20  ds "DROP INDEX" 
4c80: 66 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20  followed.by the 
4c90: 6e 61 6d 65 20 6f 66 20 74 68 65 20 69 6e 64 65  name of the inde
4ca0: 78 2e 20 20 54 68 65 20 69 6e 64 65 78 20 6e 61  x.  The index na
4cb0: 6d 65 64 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c  med is completel
4cc0: 79 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 0a 74  y removed from.t
4cd0: 68 65 20 64 69 73 6b 2e 20 20 54 68 65 20 6f 6e  he disk.  The on
4ce0: 6c 79 20 77 61 79 20 74 6f 20 72 65 63 6f 76 65  ly way to recove
4cf0: 72 20 74 68 65 20 69 6e 64 65 78 20 69 73 20 74  r the index is t
4d00: 6f 20 72 65 65 6e 74 65 72 20 74 68 65 0a 61 70  o reenter the.ap
4d10: 70 72 6f 70 72 69 61 74 65 20 43 52 45 41 54 45  propriate CREATE
4d20: 20 49 4e 44 45 58 20 63 6f 6d 6d 61 6e 64 2e 3c   INDEX command.<
4d30: 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 7b  /p>.}..Section {
4d40: 44 52 4f 50 20 54 41 42 4c 45 7d 20 64 72 6f 70  DROP TABLE} drop
4d50: 74 61 62 6c 65 0a 0a 53 79 6e 74 61 78 20 7b 73  table..Syntax {s
4d60: 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 52  ql-command} {.DR
4d70: 4f 50 20 54 41 42 4c 45 20 3c 74 61 62 6c 65 2d  OP TABLE <table-
4d80: 6e 61 6d 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a  name>.}..puts {.
4d90: 3c 70 3e 54 68 65 20 44 52 4f 50 20 54 41 42 4c  <p>The DROP TABL
4da0: 45 20 73 74 61 74 65 6d 65 6e 74 20 63 6f 6e 73  E statement cons
4db0: 69 73 74 73 20 6f 66 20 74 68 65 20 6b 65 79 77  ists of the keyw
4dc0: 6f 72 64 73 20 22 44 52 4f 50 20 54 41 42 4c 45  ords "DROP TABLE
4dd0: 22 20 66 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68  " followed.by th
4de0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61  e name of the ta
4df0: 62 6c 65 2e 20 20 54 68 65 20 74 61 62 6c 65 20  ble.  The table 
4e00: 6e 61 6d 65 64 20 69 73 20 63 6f 6d 70 6c 65 74  named is complet
4e10: 65 6c 79 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d  ely removed from
4e20: 0a 74 68 65 20 64 69 73 6b 2e 20 20 54 68 65 20  .the disk.  The 
4e30: 74 61 62 6c 65 20 63 61 6e 20 6e 6f 74 20 62 65  table can not be
4e40: 20 72 65 63 6f 76 65 72 65 64 2e 20 20 41 6c 6c   recovered.  All
4e50: 20 69 6e 64 69 63 65 73 20 61 73 73 6f 63 69 61   indices associa
4e60: 74 65 64 20 77 69 74 68 0a 74 68 65 20 74 61 62  ted with.the tab
4e70: 6c 65 20 61 72 65 20 61 6c 73 6f 20 64 65 6c 65  le are also dele
4e80: 74 65 64 2e 3c 2f 70 3e 7d 0a 0a 53 65 63 74 69  ted.</p>}..Secti
4e90: 6f 6e 20 7b 44 52 4f 50 20 54 52 49 47 47 45 52  on {DROP TRIGGER
4ea0: 7d 20 64 72 6f 70 74 72 69 67 67 65 72 0a 53 79  } droptrigger.Sy
4eb0: 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d  ntax {sql-statem
4ec0: 65 6e 74 7d 20 7b 0a 44 52 4f 50 20 54 52 49 47  ent} {.DROP TRIG
4ed0: 47 45 52 20 3c 74 72 69 67 67 65 72 2d 6e 61 6d  GER <trigger-nam
4ee0: 65 3e 0a 7d 0a 70 75 74 73 20 7b 20 0a 20 20 3c  e>.}.puts { .  <
4ef0: 70 3e 55 73 65 64 20 74 6f 20 64 72 6f 70 20 61  p>Used to drop a
4f00: 20 74 72 69 67 67 65 72 20 66 72 6f 6d 20 74 68   trigger from th
4f10: 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d  e database schem
4f20: 61 2e 20 4e 6f 74 65 20 74 68 61 74 20 74 72 69  a. Note that tri
4f30: 67 67 65 72 73 0a 20 20 61 72 65 20 61 75 74 6f  ggers.  are auto
4f40: 6d 61 74 69 63 61 6c 6c 79 20 64 72 6f 70 70 65  matically droppe
4f50: 64 20 77 68 65 6e 20 74 68 65 20 61 73 73 6f 63  d when the assoc
4f60: 69 61 74 65 64 20 74 61 62 6c 65 20 69 73 20 64  iated table is d
4f70: 72 6f 70 70 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53  ropped.</p>.}..S
4f80: 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20 56 49 45  ection {DROP VIE
4f90: 57 7d 20 64 72 6f 70 76 69 65 77 0a 0a 53 79 6e  W} dropview..Syn
4fa0: 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64  tax {sql-command
4fb0: 7d 20 7b 0a 44 52 4f 50 20 56 49 45 57 20 3c 76  } {.DROP VIEW <v
4fc0: 69 65 77 2d 6e 61 6d 65 3e 0a 7d 0a 0a 70 75 74  iew-name>.}..put
4fd0: 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52 4f 50 20  s {.<p>The DROP 
4fe0: 56 49 45 57 20 73 74 61 74 65 6d 65 6e 74 20 63  VIEW statement c
4ff0: 6f 6e 73 69 73 74 73 20 6f 66 20 74 68 65 20 6b  onsists of the k
5000: 65 79 77 6f 72 64 73 20 22 44 52 4f 50 20 56 49  eywords "DROP VI
5010: 45 57 22 20 66 6f 6c 6c 6f 77 65 64 0a 62 79 20  EW" followed.by 
5020: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
5030: 76 69 65 77 2e 20 20 54 68 65 20 76 69 65 77 20  view.  The view 
5040: 6e 61 6d 65 64 20 69 73 20 72 65 6d 6f 76 65 64  named is removed
5050: 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61   from the databa
5060: 73 65 2e 0a 42 75 74 20 6e 6f 20 61 63 74 75 61  se..But no actua
5070: 6c 20 64 61 74 61 20 69 73 20 6d 6f 64 69 66 69  l data is modifi
5080: 65 64 2e 3c 2f 70 3e 7d 0a 0a 53 65 63 74 69 6f  ed.</p>}..Sectio
5090: 6e 20 45 58 50 4c 41 49 4e 20 65 78 70 6c 61 69  n EXPLAIN explai
50a0: 6e 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  n..Syntax {sql-s
50b0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 45 58 50 4c  tatement} {.EXPL
50c0: 41 49 4e 20 3c 73 71 6c 2d 73 74 61 74 65 6d 65  AIN <sql-stateme
50d0: 6e 74 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  nt>.}..puts {.<p
50e0: 3e 54 68 65 20 45 58 50 4c 41 49 4e 20 63 6f 6d  >The EXPLAIN com
50f0: 6d 61 6e 64 20 6d 6f 64 69 66 69 65 72 20 69 73  mand modifier is
5100: 20 61 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 64 20   a non-standard 
5110: 65 78 74 65 6e 73 69 6f 6e 2e 20 20 54 68 65 0a  extension.  The.
5120: 69 64 65 61 20 63 6f 6d 65 73 20 66 72 6f 6d 20  idea comes from 
5130: 61 20 73 69 6d 69 6c 61 72 20 63 6f 6d 6d 61 6e  a similar comman
5140: 64 20 66 6f 75 6e 64 20 69 6e 20 50 6f 73 74 67  d found in Postg
5150: 72 65 53 51 4c 2c 20 62 75 74 20 74 68 65 20 6f  reSQL, but the o
5160: 70 65 72 61 74 69 6f 6e 0a 69 73 20 63 6f 6d 70  peration.is comp
5170: 6c 65 74 65 6c 79 20 64 69 66 66 65 72 65 6e 74  letely different
5180: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65  .</p>..<p>If the
5190: 20 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64   EXPLAIN keyword
51a0: 20 61 70 70 65 61 72 73 20 62 65 66 6f 72 65 20   appears before 
51b0: 61 6e 79 20 6f 74 68 65 72 20 53 51 4c 69 74 65  any other SQLite
51c0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 74 68 65   SQL command.the
51d0: 6e 20 69 6e 73 74 65 61 64 20 6f 66 20 61 63 74  n instead of act
51e0: 75 61 6c 6c 79 20 65 78 65 63 75 74 69 6e 67 20  ually executing 
51f0: 74 68 65 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65  the command, the
5200: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
5210: 77 69 6c 6c 0a 72 65 70 6f 72 74 20 62 61 63 6b  will.report back
5220: 20 74 68 65 20 73 65 71 75 65 6e 63 65 20 6f 66   the sequence of
5230: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
5240: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 74   instructions it
5250: 20 77 6f 75 6c 64 20 68 61 76 65 0a 75 73 65 64   would have.used
5260: 20 74 6f 20 65 78 65 63 75 74 65 20 74 68 65 20   to execute the 
5270: 63 6f 6d 6d 61 6e 64 20 68 61 64 20 74 68 65 20  command had the 
5280: 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 20  EXPLAIN keyword 
5290: 6e 6f 74 20 62 65 65 6e 20 70 72 65 73 65 6e 74  not been present
52a0: 2e 0a 46 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  ..For additional
52b0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f   information abo
52c0: 75 74 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  ut virtual machi
52d0: 6e 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20  ne instructions 
52e0: 73 65 65 0a 74 68 65 20 3c 61 20 68 72 65 66 3d  see.the <a href=
52f0: 22 61 72 63 68 2e 68 74 6d 6c 22 3e 61 72 63 68  "arch.html">arch
5300: 69 74 65 63 74 75 72 65 20 64 65 73 63 72 69 70  itecture descrip
5310: 74 69 6f 6e 3c 2f 61 3e 20 6f 72 20 74 68 65 20  tion</a> or the 
5320: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0a 6f 6e  documentation.on
5330: 20 3c 61 20 68 72 65 66 3d 22 6f 70 63 6f 64 65   <a href="opcode
5340: 2e 68 74 6d 6c 22 3e 61 76 61 69 6c 61 62 6c 65  .html">available
5350: 20 6f 70 63 6f 64 65 73 3c 2f 61 3e 20 66 6f 72   opcodes</a> for
5360: 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63   the virtual mac
5370: 68 69 6e 65 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63  hine.</p>.}..Sec
5380: 74 69 6f 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  tion expression 
5390: 65 78 70 72 0a 0a 53 79 6e 74 61 78 20 7b 65 78  expr..Syntax {ex
53a0: 70 72 7d 20 7b 0a 3c 65 78 70 72 3e 20 3c 62 69  pr} {.<expr> <bi
53b0: 6e 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 3e 20  nary-op> <expr> 
53c0: 7c 0a 3c 65 78 70 72 3e 20 3c 6c 69 6b 65 2d 6f  |.<expr> <like-o
53d0: 70 3e 20 3c 65 78 70 72 3e 20 7c 0a 3c 75 6e 61  p> <expr> |.<una
53e0: 72 79 2d 6f 70 3e 20 3c 65 78 70 72 3e 20 7c 0a  ry-op> <expr> |.
53f0: 28 20 3c 65 78 70 72 3e 20 29 20 7c 0a 3c 63 6f  ( <expr> ) |.<co
5400: 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 74 61  lumn-name> |.<ta
5410: 62 6c 65 2d 6e 61 6d 65 3e 20 2e 20 3c 63 6f 6c  ble-name> . <col
5420: 75 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 6c 69 74  umn-name> |.<lit
5430: 65 72 61 6c 2d 76 61 6c 75 65 3e 20 7c 0a 3c 66  eral-value> |.<f
5440: 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 3e 20 28 20  unction-name> ( 
5450: 3c 65 78 70 72 2d 6c 69 73 74 3e 20 7c 20 53 54  <expr-list> | ST
5460: 41 52 20 29 20 7c 0a 3c 65 78 70 72 3e 20 49 53  AR ) |.<expr> IS
5470: 4e 55 4c 4c 20 7c 0a 3c 65 78 70 72 3e 20 4e 4f  NULL |.<expr> NO
5480: 54 4e 55 4c 4c 20 7c 0a 3c 65 78 70 72 3e 20 5b  TNULL |.<expr> [
5490: 4e 4f 54 5d 20 42 45 54 57 45 45 4e 20 3c 65 78  NOT] BETWEEN <ex
54a0: 70 72 3e 20 41 4e 44 20 3c 65 78 70 72 3e 20 7c  pr> AND <expr> |
54b0: 0a 3c 65 78 70 72 3e 20 5b 4e 4f 54 5d 20 49 4e  .<expr> [NOT] IN
54c0: 20 28 20 3c 76 61 6c 75 65 2d 6c 69 73 74 3e 20   ( <value-list> 
54d0: 29 20 7c 0a 3c 65 78 70 72 3e 20 5b 4e 4f 54 5d  ) |.<expr> [NOT]
54e0: 20 49 4e 20 28 20 3c 73 65 6c 65 63 74 2d 73 74   IN ( <select-st
54f0: 61 74 65 6d 65 6e 74 3e 20 29 20 7c 0a 28 20 3c  atement> ) |.( <
5500: 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74  select-statement
5510: 3e 20 29 20 7c 0a 43 41 53 45 20 5b 3c 65 78 70  > ) |.CASE [<exp
5520: 72 3e 5d 20 28 20 57 48 45 4e 20 3c 65 78 70 72  r>] ( WHEN <expr
5530: 3e 20 54 48 45 4e 20 3c 65 78 70 72 3e 20 29 2b  > THEN <expr> )+
5540: 20 5b 45 4c 53 45 20 3c 65 78 70 72 3e 5d 20 45   [ELSE <expr>] E
5550: 4e 44 0a 7d 20 7b 6c 69 6b 65 2d 6f 70 7d 20 7b  ND.} {like-op} {
5560: 0a 4c 49 4b 45 20 7c 20 47 4c 4f 42 20 7c 20 4e  .LIKE | GLOB | N
5570: 4f 54 20 4c 49 4b 45 20 7c 20 4e 4f 54 20 47 4c  OT LIKE | NOT GL
5580: 4f 42 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  OB.}..puts {.<p>
5590: 54 68 69 73 20 73 65 63 74 69 6f 6e 20 69 73 20  This section is 
55a0: 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74  different from t
55b0: 68 65 20 6f 74 68 65 72 73 2e 20 20 4d 6f 73 74  he others.  Most
55c0: 20 6f 74 68 65 72 20 73 65 63 74 69 6f 6e 73 20   other sections 
55d0: 6f 66 0a 74 68 69 73 20 64 6f 63 75 6d 65 6e 74  of.this document
55e0: 20 74 61 6c 6b 73 20 61 62 6f 75 74 20 61 20 70   talks about a p
55f0: 61 72 74 69 63 75 6c 61 72 20 53 51 4c 20 63 6f  articular SQL co
5600: 6d 6d 61 6e 64 2e 20 20 54 68 69 73 20 73 65 63  mmand.  This sec
5610: 74 69 6f 6e 20 64 6f 65 73 0a 6e 6f 74 20 74 61  tion does.not ta
5620: 6c 6b 20 61 62 6f 75 74 20 61 20 73 74 61 6e 64  lk about a stand
5630: 61 6c 6f 6e 65 20 63 6f 6d 6d 61 6e 64 20 62 75  alone command bu
5640: 74 20 61 62 6f 75 74 20 22 65 78 70 72 65 73 73  t about "express
5650: 69 6f 6e 73 22 20 77 68 69 63 68 20 61 72 65 20  ions" which are 
5660: 0a 73 75 62 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66  .subcomponent of
5670: 20 6d 6f 73 74 20 6f 74 68 65 72 20 63 6f 6d 6d   most other comm
5680: 61 6e 64 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51  ands.</p>..<p>SQ
5690: 4c 69 74 65 20 75 6e 64 65 72 73 74 61 6e 64 73  Lite understands
56a0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62   the following b
56b0: 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 73 2c  inary operators,
56c0: 20 69 6e 20 6f 72 64 65 72 20 66 72 6f 6d 0a 68   in order from.h
56d0: 69 67 68 65 73 74 20 74 6f 20 6c 6f 77 65 73 74  ighest to lowest
56e0: 20 70 72 65 63 65 64 65 6e 63 65 3a 3c 2f 70 3e   precedence:</p>
56f0: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70  ..<blockquote><p
5700: 72 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d  re>.<font color=
5710: 22 23 32 63 32 63 66 30 22 3e 3c 62 69 67 3e 7c  "#2c2cf0"><big>|
5720: 7c 0a 2a 20 20 20 20 2f 20 20 20 20 25 0a 2b 20  |.*    /    %.+ 
5730: 20 20 20 2d 0a 26 6c 74 3b 26 6c 74 3b 20 20 20     -.&lt;&lt;   
5740: 26 67 74 3b 26 67 74 3b 20 20 20 26 61 6d 70 3b  &gt;&gt;   &amp;
5750: 20 20 20 20 7c 0a 26 6c 74 3b 20 20 20 20 26 6c      |.&lt;    &l
5760: 74 3b 3d 20 20 20 26 67 74 3b 20 20 20 20 26 67  t;=   &gt;    &g
5770: 74 3b 3d 0a 3d 20 20 20 20 3d 3d 20 20 20 21 3d  t;=.=    ==   !=
5780: 20 20 20 26 6c 74 3b 26 67 74 3b 20 20 20 3c 2f     &lt;&gt;   </
5790: 62 69 67 3e 49 4e 0a 41 4e 44 20 20 20 0a 4f 52  big>IN.AND   .OR
57a0: 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72 65 3e 3c 2f  </font>.</pre></
57b0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e  blockquote>..<p>
57c0: 53 75 70 70 6f 72 74 65 64 20 75 6e 61 72 79 20  Supported unary 
57d0: 6f 70 65 72 61 74 65 72 73 20 61 72 65 20 74 68  operaters are th
57e0: 65 73 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b  ese:</p>..<block
57f0: 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e  quote><pre>.<fon
5800: 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30  t color="#2c2cf0
5810: 22 3e 3c 62 69 67 3e 2d 20 20 20 20 2b 20 20 20  "><big>-    +   
5820: 20 21 20 20 20 20 7e 3c 2f 62 69 67 3e 3c 2f 66   !    ~</big></f
5830: 6f 6e 74 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  ont>.</pre></blo
5840: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 41 6e 79  ckquote>..<p>Any
5850: 20 53 51 4c 69 74 65 20 76 61 6c 75 65 20 63 61   SQLite value ca
5860: 6e 20 62 65 20 75 73 65 64 20 61 73 20 70 61 72  n be used as par
5870: 74 20 6f 66 20 61 6e 20 65 78 70 72 65 73 73 69  t of an expressi
5880: 6f 6e 2e 20 20 0a 46 6f 72 20 61 72 69 74 68 6d  on.  .For arithm
5890: 65 74 69 63 20 6f 70 65 72 61 74 69 6f 6e 73 2c  etic operations,
58a0: 20 69 6e 74 65 67 65 72 73 20 61 72 65 20 74 72   integers are tr
58b0: 65 61 74 65 64 20 61 73 20 69 6e 74 65 67 65 72  eated as integer
58c0: 73 2e 0a 53 74 72 69 6e 67 73 20 61 72 65 20 66  s..Strings are f
58d0: 69 72 73 74 20 63 6f 6e 76 65 72 74 65 64 20 74  irst converted t
58e0: 6f 20 72 65 61 6c 20 6e 75 6d 62 65 72 73 20 75  o real numbers u
58f0: 73 69 6e 67 20 3c 62 3e 61 74 6f 66 28 29 3c 2f  sing <b>atof()</
5900: 62 3e 2e 0a 46 6f 72 20 63 6f 6d 70 61 72 69 73  b>..For comparis
5910: 6f 6e 20 6f 70 65 72 61 74 6f 72 73 2c 20 6e 75  on operators, nu
5920: 6d 62 65 72 73 20 63 6f 6d 70 61 72 65 20 61 73  mbers compare as
5930: 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 73 74 72   numbers and str
5940: 69 6e 67 73 0a 63 6f 6d 70 61 72 65 20 61 73 20  ings.compare as 
5950: 73 74 72 69 6e 67 73 2e 20 20 46 6f 72 20 73 74  strings.  For st
5960: 72 69 6e 67 20 63 6f 6d 70 61 72 69 73 6f 6e 73  ring comparisons
5970: 2c 20 63 61 73 65 20 69 73 20 73 69 67 6e 69 66  , case is signif
5980: 69 63 61 6e 74 0a 62 75 74 20 69 73 20 6f 6e 6c  icant.but is onl
5990: 79 20 75 73 65 64 20 74 6f 20 62 72 65 61 6b 20  y used to break 
59a0: 61 20 74 69 65 2e 0a 4e 6f 74 65 20 74 68 61 74  a tie..Note that
59b0: 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 76   there are two v
59c0: 61 72 69 61 74 69 6f 6e 73 20 6f 66 20 74 68 65  ariations of the
59d0: 20 65 71 75 61 6c 73 20 61 6e 64 20 6e 6f 74 20   equals and not 
59e0: 65 71 75 61 6c 73 0a 6f 70 65 72 61 74 6f 72 73  equals.operators
59f0: 2e 20 20 45 71 75 61 6c 73 20 63 61 6e 20 62 65  .  Equals can be
5a00: 20 65 69 74 68 65 72 7d 0a 70 75 74 73 20 22 5b   either}.puts "[
5a10: 4f 70 65 72 61 74 6f 72 20 3d 5d 20 6f 72 20 5b  Operator =] or [
5a20: 4f 70 65 72 61 74 6f 72 20 3d 3d 5d 2e 0a 54 68  Operator ==]..Th
5a30: 65 20 6e 6f 6e 2d 65 71 75 61 6c 73 20 6f 70 65  e non-equals ope
5a40: 72 61 74 6f 72 20 63 61 6e 20 62 65 20 65 69 74  rator can be eit
5a50: 68 65 72 0a 5b 4f 70 65 72 61 74 6f 72 20 21 3d  her.[Operator !=
5a60: 5d 20 6f 72 20 5b 4f 70 65 72 61 74 6f 72 20 7b  ] or [Operator {
5a70: 26 6c 74 3b 26 67 74 3b 7d 5d 2e 0a 54 68 65 20  &lt;&gt;}]..The 
5a80: 5b 4f 70 65 72 61 74 6f 72 20 7c 7c 5d 20 6f 70  [Operator ||] op
5a90: 65 72 61 74 6f 72 20 69 73 20 5c 22 63 6f 6e 63  erator is \"conc
5aa0: 61 74 65 6e 61 74 65 5c 22 20 2d 20 69 74 20 6a  atenate\" - it j
5ab0: 6f 69 6e 73 20 74 6f 67 65 74 68 65 72 0a 74 68  oins together.th
5ac0: 65 20 74 77 6f 20 73 74 72 69 6e 67 73 20 6f 66  e two strings of
5ad0: 20 69 74 73 20 6f 70 65 72 61 6e 64 73 2e 3c 2f   its operands.</
5ae0: 70 3e 22 0a 70 75 74 73 20 7b 0a 0a 3c 70 3e 54  p>".puts {..<p>T
5af0: 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72  he LIKE operator
5b00: 20 64 6f 65 73 20 61 20 77 69 6c 64 63 61 72 64   does a wildcard
5b10: 20 63 6f 6d 70 61 72 69 73 69 6f 6e 2e 20 20 54   comparision.  T
5b20: 68 65 20 6f 70 65 72 61 6e 64 0a 74 6f 20 74 68  he operand.to th
5b30: 65 20 72 69 67 68 74 20 63 6f 6e 74 61 69 6e 73  e right contains
5b40: 20 74 68 65 20 77 69 6c 64 63 61 72 64 73 2e 7d   the wildcards.}
5b50: 0a 70 75 74 73 20 22 41 20 70 65 72 63 65 6e 74  .puts "A percent
5b60: 20 73 79 6d 62 6f 6c 20 5b 4f 70 65 72 61 74 6f   symbol [Operato
5b70: 72 20 25 5d 20 69 6e 20 74 68 65 20 72 69 67 68  r %] in the righ
5b80: 74 20 6f 70 65 72 61 6e 64 0a 6d 61 74 63 68 65  t operand.matche
5b90: 73 20 61 6e 79 20 73 65 71 75 65 6e 63 65 20 6f  s any sequence o
5ba0: 66 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 63  f zero or more c
5bb0: 68 61 72 61 63 74 65 72 73 20 6f 6e 20 74 68 65  haracters on the
5bc0: 20 6c 65 66 74 2e 0a 41 6e 20 75 6e 64 65 72 73   left..An unders
5bd0: 63 6f 72 65 20 5b 4f 70 65 72 61 74 6f 72 20 5f  core [Operator _
5be0: 5d 20 6f 6e 20 74 68 65 20 72 69 67 68 74 0a 6d  ] on the right.m
5bf0: 61 74 63 68 65 73 20 61 6e 79 20 73 69 6e 67 6c  atches any singl
5c00: 65 20 63 68 61 72 61 63 74 65 72 20 6f 6e 20 74  e character on t
5c10: 68 65 20 6c 65 66 74 2e 22 0a 70 75 74 73 20 7b  he left.".puts {
5c20: 54 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  The LIKE operato
5c30: 72 20 69 73 0a 6e 6f 74 20 63 61 73 65 20 73 65  r is.not case se
5c40: 6e 73 69 74 69 76 65 20 61 6e 64 20 77 69 6c 6c  nsitive and will
5c50: 20 6d 61 74 63 68 20 75 70 70 65 72 20 63 61 73   match upper cas
5c60: 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e 20  e characters on 
5c70: 6f 6e 65 0a 73 69 64 65 20 61 67 61 69 6e 73 74  one.side against
5c80: 20 6c 6f 77 65 72 20 63 61 73 65 20 63 68 61 72   lower case char
5c90: 61 63 74 65 72 73 20 6f 6e 20 74 68 65 20 6f 74  acters on the ot
5ca0: 68 65 72 2e 0a 28 41 20 62 75 67 3a 20 53 51 4c  her..(A bug: SQL
5cb0: 69 74 65 20 6f 6e 6c 79 20 75 6e 64 65 72 73 74  ite only underst
5cc0: 61 6e 64 73 20 75 70 70 65 72 2f 6c 6f 77 65 72  ands upper/lower
5cd0: 20 63 61 73 65 20 66 6f 72 20 37 2d 62 69 74 20   case for 7-bit 
5ce0: 4c 61 74 69 6e 0a 63 68 61 72 61 63 74 65 72 73  Latin.characters
5cf0: 2e 20 20 48 65 6e 63 65 20 74 68 65 20 4c 49 4b  .  Hence the LIK
5d00: 45 20 6f 70 65 72 61 74 6f 72 20 69 73 20 63 61  E operator is ca
5d10: 73 65 20 73 65 6e 73 69 74 69 76 65 20 66 6f 72  se sensitive for
5d20: 0a 38 2d 62 69 74 20 69 73 6f 38 38 35 39 20 63  .8-bit iso8859 c
5d30: 68 61 72 61 63 74 65 72 73 20 6f 72 20 55 54 46  haracters or UTF
5d40: 2d 38 20 63 68 61 72 61 63 74 65 72 73 2e 20 20  -8 characters.  
5d50: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 74 68 65  For example,.the
5d60: 20 65 78 70 72 65 73 73 69 6f 6e 20 3c 62 3e 27   expression <b>'
5d70: 61 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62 73  a'&nbsp;LIKE&nbs
5d80: 70 3b 27 41 27 3c 2f 62 3e 20 69 73 20 54 52 55  p;'A'</b> is TRU
5d90: 45 20 62 75 74 0a 3c 62 3e 27 26 61 65 6c 69 67  E but.<b>'&aelig
5da0: 3b 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62 73  ;'&nbsp;LIKE&nbs
5db0: 70 3b 27 26 41 45 6c 69 67 3b 27 3c 2f 62 3e 20  p;'&AElig;'</b> 
5dc0: 69 73 20 46 41 4c 53 45 2e 29 0a 3c 2f 70 3e 0a  is FALSE.).</p>.
5dd0: 0a 3c 70 3e 54 68 65 20 47 4c 4f 42 20 6f 70 65  .<p>The GLOB ope
5de0: 72 61 74 6f 72 20 69 73 20 73 69 6d 69 6c 61 72  rator is similar
5df0: 20 74 6f 20 4c 49 4b 45 20 62 75 74 20 75 73 65   to LIKE but use
5e00: 73 20 74 68 65 20 55 6e 69 78 0a 66 69 6c 65 20  s the Unix.file 
5e10: 67 6c 6f 62 62 69 6e 67 20 73 79 6e 74 61 78 20  globbing syntax 
5e20: 66 6f 72 20 69 74 73 20 77 69 6c 64 63 61 72 64  for its wildcard
5e30: 73 2e 20 20 41 6c 73 6f 2c 20 47 4c 4f 42 20 69  s.  Also, GLOB i
5e40: 73 20 63 61 73 65 0a 73 65 6e 73 69 74 69 76 65  s case.sensitive
5e50: 2c 20 75 6e 6c 69 6b 65 20 4c 49 4b 45 2e 20 20  , unlike LIKE.  
5e60: 42 6f 74 68 20 47 4c 4f 42 20 61 6e 64 20 4c 49  Both GLOB and LI
5e70: 4b 45 20 6d 61 79 20 62 65 20 70 72 65 63 65 64  KE may be preced
5e80: 65 64 20 62 79 0a 74 68 65 20 4e 4f 54 20 6b 65  ed by.the NOT ke
5e90: 79 77 6f 72 64 20 74 6f 20 69 6e 76 65 72 74 20  yword to invert 
5ea0: 74 68 65 20 73 65 6e 73 65 20 6f 66 20 74 68 65  the sense of the
5eb0: 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41   test.</p>..<p>A
5ec0: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61 6e   column name can
5ed0: 20 62 65 20 61 6e 79 20 6f 66 20 74 68 65 20 6e   be any of the n
5ee0: 61 6d 65 73 20 64 65 66 69 6e 65 64 20 69 6e 20  ames defined in 
5ef0: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
5f00: 0a 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 6f 6e  .statement or on
5f10: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  e of the followi
5f20: 6e 67 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74  ng special ident
5f30: 69 66 69 65 72 73 3a 20 22 3c 62 3e 52 4f 57 49  ifiers: "<b>ROWI
5f40: 44 3c 2f 62 3e 22 2c 0a 22 3c 62 3e 4f 49 44 3c  D</b>",."<b>OID<
5f50: 2f 62 3e 22 2c 20 6f 72 20 22 3c 62 3e 5f 52 4f  /b>", or "<b>_RO
5f60: 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54 68 65 73 65  WID_</b>"..These
5f70: 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74 69 66   special identif
5f80: 69 65 72 73 20 61 6c 6c 20 64 65 73 63 72 69 62  iers all describ
5f90: 65 20 74 68 65 0a 75 6e 69 71 75 65 20 72 61 6e  e the.unique ran
5fa0: 64 6f 6d 20 69 6e 74 65 67 65 72 20 6b 65 79 20  dom integer key 
5fb0: 28 74 68 65 20 22 72 6f 77 20 6b 65 79 22 29 20  (the "row key") 
5fc0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
5fd0: 65 76 65 72 79 20 0a 72 6f 77 20 6f 66 20 65 76  every .row of ev
5fe0: 65 72 79 20 74 61 62 6c 65 2e 0a 54 68 65 20 73  ery table..The s
5ff0: 70 65 63 69 61 6c 20 69 64 65 6e 74 69 66 69 65  pecial identifie
6000: 72 73 20 6f 6e 6c 79 20 72 65 66 65 72 20 74 6f  rs only refer to
6010: 20 74 68 65 20 72 6f 77 20 6b 65 79 20 69 66 20   the row key if 
6020: 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45  the CREATE TABLE
6030: 0a 73 74 61 74 65 6d 65 6e 74 20 64 6f 65 73 20  .statement does 
6040: 6e 6f 74 20 64 65 66 69 6e 65 20 61 20 72 65 61  not define a rea
6050: 6c 20 63 6f 6c 75 6d 6e 20 77 69 74 68 20 74 68  l column with th
6060: 65 20 73 61 6d 65 20 6e 61 6d 65 2e 20 20 52 6f  e same name.  Ro
6070: 77 20 6b 65 79 73 0a 61 63 74 20 6c 69 6b 65 20  w keys.act like 
6080: 72 65 61 64 2d 6f 6e 6c 79 20 63 6f 6c 75 6d 6e  read-only column
6090: 73 2e 20 20 41 20 72 6f 77 20 6b 65 79 20 63 61  s.  A row key ca
60a0: 6e 20 62 65 20 75 73 65 64 20 61 6e 79 77 68 65  n be used anywhe
60b0: 72 65 20 61 20 72 65 67 75 6c 61 72 0a 63 6f 6c  re a regular.col
60c0: 75 6d 6e 20 63 61 6e 20 62 65 20 75 73 65 64 2c  umn can be used,
60d0: 20 65 78 63 65 70 74 20 74 68 61 74 20 79 6f 75   except that you
60e0: 20 63 61 6e 6e 6f 74 20 63 68 61 6e 67 65 20 74   cannot change t
60f0: 68 65 20 76 61 6c 75 65 0a 6f 66 20 61 20 72 6f  he value.of a ro
6100: 77 20 6b 65 79 20 69 6e 20 61 6e 20 55 50 44 41  w key in an UPDA
6110: 54 45 20 6f 72 20 49 4e 53 45 52 54 20 73 74 61  TE or INSERT sta
6120: 74 65 6d 65 6e 74 2e 0a 22 53 45 4c 45 43 54 20  tement.."SELECT 
6130: 2a 20 2e 2e 2e 22 20 64 6f 65 73 20 6e 6f 74 20  * ..." does not 
6140: 72 65 74 75 72 6e 20 74 68 65 20 72 6f 77 20 6b  return the row k
6150: 65 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 45 4c 45  ey.</p>..<p>SELE
6160: 43 54 20 73 74 61 74 65 6d 65 6e 74 73 20 63 61  CT statements ca
6170: 6e 20 61 70 70 65 61 72 20 69 6e 20 65 78 70 72  n appear in expr
6180: 65 73 73 69 6f 6e 73 20 61 73 20 65 69 74 68 65  essions as eithe
6190: 72 20 74 68 65 0a 72 69 67 68 74 2d 68 61 6e 64  r the.right-hand
61a0: 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68 65 20   operand of the 
61b0: 49 4e 20 6f 70 65 72 61 74 6f 72 20 6f 72 20 61  IN operator or a
61c0: 73 20 61 20 73 63 61 6c 61 72 20 71 75 61 6e 74  s a scalar quant
61d0: 69 74 79 2e 0a 49 6e 20 62 6f 74 68 20 63 61 73  ity..In both cas
61e0: 65 73 2c 20 74 68 65 20 53 45 4c 45 43 54 20 73  es, the SELECT s
61f0: 68 6f 75 6c 64 20 68 61 76 65 20 6f 6e 6c 79 20  hould have only 
6200: 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 20  a single column 
6210: 69 6e 20 69 74 73 0a 72 65 73 75 6c 74 2e 20 20  in its.result.  
6220: 43 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 73  Compound SELECTs
6230: 20 28 63 6f 6e 6e 65 63 74 65 64 20 77 69 74 68   (connected with
6240: 20 6b 65 79 77 6f 72 64 73 20 6c 69 6b 65 20 55   keywords like U
6250: 4e 49 4f 4e 20 6f 72 0a 45 58 43 45 50 54 29 20  NION or.EXCEPT) 
6260: 61 72 65 20 61 6c 6c 6f 77 65 64 2e 20 20 41 6e  are allowed.  An
6270: 79 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  y ORDER BY claus
6280: 65 20 6f 6e 20 74 68 65 20 73 65 6c 65 63 74 20  e on the select 
6290: 69 73 20 69 67 6e 6f 72 65 64 2e 0a 41 20 53 45  is ignored..A SE
62a0: 4c 45 43 54 20 69 6e 20 61 6e 20 65 78 70 72 65  LECT in an expre
62b0: 73 73 69 6f 6e 20 69 73 20 65 76 61 6c 75 61 74  ssion is evaluat
62c0: 65 64 20 6f 6e 63 65 20 62 65 66 6f 72 65 20 61  ed once before a
62d0: 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73  ny other process
62e0: 69 6e 67 0a 69 73 20 70 65 72 66 6f 72 6d 65 64  ing.is performed
62f0: 2c 20 73 6f 20 6e 6f 6e 65 20 6f 66 20 74 68 65  , so none of the
6300: 20 65 78 70 72 65 73 73 69 6f 6e 73 20 77 69 74   expressions wit
6310: 68 69 6e 20 74 68 65 20 73 65 6c 65 63 74 20 69  hin the select i
6320: 74 73 65 6c 66 20 63 61 6e 0a 72 65 66 65 72 20  tself can.refer 
6330: 74 6f 20 71 75 61 6e 74 69 74 69 65 73 20 69 6e  to quantities in
6340: 20 74 68 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20   the containing 
6350: 65 78 70 72 65 73 73 69 6f 6e 2e 3c 2f 70 3e 0a  expression.</p>.
6360: 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c 45 43  .<p>When a SELEC
6370: 54 20 69 73 20 74 68 65 20 72 69 67 68 74 20 6f  T is the right o
6380: 70 65 72 61 6e 64 20 6f 66 20 74 68 65 20 49 4e  perand of the IN
6390: 20 6f 70 65 72 61 74 6f 72 2c 20 74 68 65 20 49   operator, the I
63a0: 4e 0a 6f 70 65 72 61 74 6f 72 20 72 65 74 75 72  N.operator retur
63b0: 6e 73 20 54 52 55 45 20 69 66 20 74 68 65 20 72  ns TRUE if the r
63c0: 65 73 75 6c 74 20 6f 66 20 74 68 65 20 6c 65 66  esult of the lef
63d0: 74 20 6f 70 65 72 61 6e 64 20 69 73 20 61 6e 79  t operand is any
63e0: 20 6f 66 0a 74 68 65 20 76 61 6c 75 65 73 20 67   of.the values g
63f0: 65 6e 65 72 61 74 65 64 20 62 79 20 74 68 65 20  enerated by the 
6400: 73 65 6c 65 63 74 2e 20 20 54 68 65 20 49 4e 20  select.  The IN 
6410: 6f 70 65 72 61 74 6f 72 20 6d 61 79 20 62 65 20  operator may be 
6420: 70 72 65 63 65 64 65 64 0a 62 79 20 74 68 65 20  preceded.by the 
6430: 4e 4f 54 20 6b 65 79 77 6f 72 64 20 74 6f 20 69  NOT keyword to i
6440: 6e 76 65 72 74 20 74 68 65 20 73 65 6e 73 65 20  nvert the sense 
6450: 6f 66 20 74 68 65 20 74 65 73 74 2e 3c 2f 70 3e  of the test.</p>
6460: 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c 45  ..<p>When a SELE
6470: 43 54 20 61 70 70 65 61 72 73 20 77 69 74 68 69  CT appears withi
6480: 6e 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  n an expression 
6490: 62 75 74 20 69 73 20 6e 6f 74 20 74 68 65 20 72  but is not the r
64a0: 69 67 68 74 0a 6f 70 65 72 61 6e 64 20 6f 66 20  ight.operand of 
64b0: 61 6e 20 49 4e 20 6f 70 65 72 61 74 6f 72 2c 20  an IN operator, 
64c0: 74 68 65 6e 20 74 68 65 20 66 69 72 73 74 20 72  then the first r
64d0: 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ow of the result
64e0: 20 6f 66 20 74 68 65 0a 53 45 4c 45 43 54 20 62   of the.SELECT b
64f0: 65 63 6f 6d 65 73 20 74 68 65 20 76 61 6c 75 65  ecomes the value
6500: 20 75 73 65 64 20 69 6e 20 74 68 65 20 65 78 70   used in the exp
6510: 72 65 73 73 69 6f 6e 2e 20 20 49 66 20 74 68 65  ression.  If the
6520: 20 53 45 4c 45 43 54 20 79 69 65 6c 64 73 0a 6d   SELECT yields.m
6530: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 65 73  ore than one res
6540: 75 6c 74 20 72 6f 77 2c 20 61 6c 6c 20 72 6f 77  ult row, all row
6550: 73 20 61 66 74 65 72 20 74 68 65 20 66 69 72 73  s after the firs
6560: 74 20 61 72 65 20 69 67 6e 6f 72 65 64 2e 20 20  t are ignored.  
6570: 49 66 0a 74 68 65 20 53 45 4c 45 43 54 20 79 65  If.the SELECT ye
6580: 69 6c 64 73 20 6e 6f 20 72 6f 77 73 2c 20 74 68  ilds no rows, th
6590: 65 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  en the value of 
65a0: 74 68 65 20 53 45 4c 45 43 54 20 69 73 20 4e 55  the SELECT is NU
65b0: 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 42 6f 74 68  LL.</p>..<p>Both
65c0: 20 73 69 6d 70 6c 65 20 61 6e 64 20 61 67 67 72   simple and aggr
65d0: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20  egate functions 
65e0: 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e 20 20  are supported.  
65f0: 41 20 73 69 6d 70 6c 65 0a 66 75 6e 63 74 69 6f  A simple.functio
6600: 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e  n can be used in
6610: 20 61 6e 79 20 65 78 70 72 65 73 73 69 6f 6e 2e   any expression.
6620: 20 20 53 69 6d 70 6c 65 20 66 75 6e 63 74 69 6f    Simple functio
6630: 6e 73 20 72 65 74 75 72 6e 0a 61 20 72 65 73 75  ns return.a resu
6640: 6c 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 62  lt immediately b
6650: 61 73 65 64 20 6f 6e 20 74 68 65 69 72 20 69 6e  ased on their in
6660: 70 75 74 73 2e 20 20 41 67 67 72 65 67 61 74 65  puts.  Aggregate
6670: 20 66 75 6e 63 74 69 6f 6e 73 0a 6d 61 79 20 6f   functions.may o
6680: 6e 6c 79 20 62 65 20 75 73 65 64 20 69 6e 20 61  nly be used in a
6690: 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e   SELECT statemen
66a0: 74 2e 20 20 41 67 67 72 65 67 61 74 65 20 66 75  t.  Aggregate fu
66b0: 6e 63 74 69 6f 6e 73 20 63 6f 6d 70 75 74 65 0a  nctions compute.
66c0: 74 68 65 69 72 20 72 65 73 75 6c 74 20 61 63 72  their result acr
66d0: 6f 73 73 20 61 6c 6c 20 72 6f 77 73 20 6f 66 20  oss all rows of 
66e0: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e 3c  the result set.<
66f0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c  /p>..<p>The foll
6700: 6f 77 69 6e 67 20 73 69 6d 70 6c 65 20 66 75 6e  owing simple fun
6710: 63 74 69 6f 6e 73 20 61 72 65 20 63 75 72 72 65  ctions are curre
6720: 6e 74 6c 79 20 73 75 70 70 6f 72 74 65 64 3a 3c  ntly supported:<
6730: 2f 70 3e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72 64  /p>..<table bord
6740: 65 72 3d 30 20 63 65 6c 6c 70 61 64 64 69 6e 67  er=0 cellpadding
6750: 3d 31 30 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  =10>.<tr>.<td va
6760: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
6770: 3d 22 72 69 67 68 74 22 20 77 69 64 74 68 3d 31  ="right" width=1
6780: 32 30 3e 61 62 73 28 3c 69 3e 58 3c 2f 69 3e 29  20>abs(<i>X</i>)
6790: 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e  </td>.<td valign
67a0: 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68  ="top">Return th
67b0: 65 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75 65  e absolute value
67c0: 20 6f 66 20 61 72 67 75 6d 65 6e 74 20 3c 69 3e   of argument <i>
67d0: 58 3c 2f 69 3e 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  X</i>.</td>.</tr
67e0: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
67f0: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
6800: 72 69 67 68 74 22 3e 63 6f 61 6c 65 73 63 65 28  right">coalesce(
6810: 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c 2f 69  <i>X</i>,<i>Y</i
6820: 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e 0a 3c 74 64 20  >,...)</td>.<td 
6830: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
6840: 75 72 6e 20 61 20 63 6f 70 79 20 6f 66 20 74 68  urn a copy of th
6850: 65 20 66 69 72 73 74 20 6e 6f 6e 2d 4e 55 4c 4c  e first non-NULL
6860: 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 66 0a 61   argument.  If.a
6870: 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65  ll arguments are
6880: 20 4e 55 4c 4c 20 74 68 65 6e 20 4e 55 4c 4c 20   NULL then NULL 
6890: 69 73 20 72 65 74 75 72 6e 65 64 2e 3c 2f 74 64  is returned.</td
68a0: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
68b0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
68c0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6c 61 73  lign="right">las
68d0: 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29  t_insert_rowid()
68e0: 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e  </td>.<td valign
68f0: 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68  ="top">Return th
6900: 65 20 52 4f 57 49 44 20 6f 66 20 74 68 65 20 6c  e ROWID of the l
6910: 61 73 74 20 72 6f 77 20 69 6e 73 65 72 74 20 66  ast row insert f
6920: 72 6f 6d 20 74 68 69 73 0a 63 6f 6e 6e 65 63 74  rom this.connect
6930: 69 6f 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62  ion to the datab
6940: 61 73 65 2e 20 20 54 68 69 73 20 69 73 20 74 68  ase.  This is th
6950: 65 20 73 61 6d 65 20 76 61 6c 75 65 20 74 68 61  e same value tha
6960: 74 20 77 6f 75 6c 64 20 62 65 20 72 65 74 75 72  t would be retur
6970: 6e 65 64 0a 66 72 6f 6d 20 74 68 65 20 3c 62 3e  ned.from the <b>
6980: 73 71 6c 69 74 65 5f 6c 61 73 74 5f 69 6e 73 65  sqlite_last_inse
6990: 72 74 5f 72 6f 77 69 64 28 29 3c 2f 62 3e 20 41  rt_rowid()</b> A
69a0: 50 49 20 66 75 6e 63 74 69 6f 6e 2e 3c 2f 74 64  PI function.</td
69b0: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
69c0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
69d0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6c 65 6e  lign="right">len
69e0: 67 74 68 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74  gth(<i>X</i>)</t
69f0: 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  d>.<td valign="t
6a00: 6f 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 73  op">Return the s
6a10: 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 6f 66 20  tring length of 
6a20: 3c 69 3e 58 3c 2f 69 3e 20 69 6e 20 63 68 61 72  <i>X</i> in char
6a30: 61 63 74 65 72 73 2e 0a 49 66 20 53 51 4c 69 74  acters..If SQLit
6a40: 65 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20  e is configured 
6a50: 74 6f 20 73 75 70 70 6f 72 74 20 55 54 46 2d 38  to support UTF-8
6a60: 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65  , then the numbe
6a70: 72 20 6f 66 20 55 54 46 2d 38 0a 63 68 61 72 61  r of UTF-8.chara
6a80: 63 74 65 72 73 20 69 73 20 72 65 74 75 72 6e 65  cters is returne
6a90: 64 2c 20 6e 6f 74 20 74 68 65 20 6e 75 6d 62 65  d, not the numbe
6aa0: 72 20 6f 66 20 62 79 74 65 73 2e 3c 2f 74 64 3e  r of bytes.</td>
6ab0: 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64  .</tr>..<tr>.<td
6ac0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c   valign="top" al
6ad0: 69 67 6e 3d 22 72 69 67 68 74 22 3e 6c 6f 77 65  ign="right">lowe
6ae0: 72 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e  r(<i>X</i>)</td>
6af0: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
6b00: 22 3e 52 65 74 75 72 6e 20 61 20 63 6f 70 79 20  ">Return a copy 
6b10: 6f 66 20 73 74 72 69 6e 67 20 3c 69 3e 58 3c 2f  of string <i>X</
6b20: 69 3e 20 77 69 6c 6c 20 61 6c 6c 20 63 68 61 72  i> will all char
6b30: 61 63 74 65 72 73 0a 63 6f 6e 76 65 72 74 65 64  acters.converted
6b40: 20 74 6f 20 6c 6f 77 65 72 20 63 61 73 65 2e 20   to lower case. 
6b50: 20 54 68 65 20 43 20 6c 69 62 72 61 72 79 20 3c   The C library <
6b60: 62 3e 74 6f 6c 6f 77 65 72 28 29 3c 2f 62 3e 20  b>tolower()</b> 
6b70: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 0a  routine is used.
6b80: 66 6f 72 20 74 68 65 20 63 6f 6e 76 65 72 73 69  for the conversi
6b90: 6f 6e 2c 20 77 68 69 63 68 20 6d 65 61 6e 73 20  on, which means 
6ba0: 74 68 61 74 20 74 68 69 73 20 66 75 6e 63 74 69  that this functi
6bb0: 6f 6e 20 6d 69 67 68 74 20 6e 6f 74 0a 77 6f 72  on might not.wor
6bc0: 6b 20 63 6f 72 72 65 63 74 6c 79 20 6f 6e 20 55  k correctly on U
6bd0: 54 46 2d 38 20 63 68 61 72 61 63 74 65 72 73 2e  TF-8 characters.
6be0: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72  </td>.</tr>..<tr
6bf0: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
6c00: 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22  p" align="right"
6c10: 3e 6d 61 78 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69  >max(<i>X</i>,<i
6c20: 3e 59 3c 2f 69 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e  >Y</i>,...)</td>
6c30: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
6c40: 22 3e 52 65 74 75 72 6e 20 74 68 65 20 61 72 67  ">Return the arg
6c50: 75 6d 65 6e 74 20 77 69 74 68 20 74 68 65 20 6d  ument with the m
6c60: 61 78 69 6d 75 6d 20 76 61 6c 75 65 2e 20 20 41  aximum value.  A
6c70: 72 67 75 6d 65 6e 74 73 0a 6d 61 79 20 62 65 20  rguments.may be 
6c80: 73 74 72 69 6e 67 73 20 69 6e 20 61 64 64 69 74  strings in addit
6c90: 69 6f 6e 20 74 6f 20 6e 75 6d 62 65 72 73 2e 20  ion to numbers. 
6ca0: 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 76 61 6c   The maximum val
6cb0: 75 65 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64  ue is determined
6cc0: 0a 62 79 20 74 68 65 20 75 73 75 61 6c 20 73 6f  .by the usual so
6cd0: 72 74 20 6f 72 64 65 72 2e 20 20 4e 6f 74 65 20  rt order.  Note 
6ce0: 74 68 61 74 20 3c 62 3e 6d 61 78 28 29 3c 2f 62  that <b>max()</b
6cf0: 3e 20 69 73 20 61 20 73 69 6d 70 6c 65 20 66 75  > is a simple fu
6d00: 6e 63 74 69 6f 6e 20 77 68 65 6e 0a 69 74 20 68  nction when.it h
6d10: 61 73 20 32 20 6f 72 20 6d 6f 72 65 20 61 72 67  as 2 or more arg
6d20: 75 6d 65 6e 74 73 20 62 75 74 20 63 6f 6e 76 65  uments but conve
6d30: 72 74 73 20 74 6f 20 61 6e 20 61 67 67 72 65 67  rts to an aggreg
6d40: 61 74 65 20 66 75 6e 63 74 69 6f 6e 20 69 66 20  ate function if 
6d50: 67 69 76 65 6e 0a 6f 6e 6c 79 20 61 20 73 69 6e  given.only a sin
6d60: 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 74  gle argument.</t
6d70: 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c  d>.</tr>..<tr>.<
6d80: 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20  td valign="top" 
6d90: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d 69  align="right">mi
6da0: 6e 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c  n(<i>X</i>,<i>Y<
6db0: 2f 69 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e 0a 3c 74  /i>,...)</td>.<t
6dc0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52  d valign="top">R
6dd0: 65 74 75 72 6e 20 74 68 65 20 61 72 67 75 6d 65  eturn the argume
6de0: 6e 74 20 77 69 74 68 20 74 68 65 20 6d 69 6e 69  nt with the mini
6df0: 6d 75 6d 20 76 61 6c 75 65 2e 20 20 41 72 67 75  mum value.  Argu
6e00: 6d 65 6e 74 73 0a 6d 61 79 20 62 65 20 73 74 72  ments.may be str
6e10: 69 6e 67 73 20 69 6e 20 61 64 64 69 74 69 6f 6e  ings in addition
6e20: 20 74 6f 20 6e 75 6d 62 65 72 73 2e 20 20 54 68   to numbers.  Th
6e30: 65 20 6d 6d 69 6e 69 6d 75 6d 20 76 61 6c 75 65  e mminimum value
6e40: 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 0a 62   is determined.b
6e50: 79 20 74 68 65 20 75 73 75 61 6c 20 73 6f 72 74  y the usual sort
6e60: 20 6f 72 64 65 72 2e 20 20 4e 6f 74 65 20 74 68   order.  Note th
6e70: 61 74 20 3c 62 3e 6d 69 6e 28 29 3c 2f 62 3e 20  at <b>min()</b> 
6e80: 69 73 20 61 20 73 69 6d 70 6c 65 20 66 75 6e 63  is a simple func
6e90: 74 69 6f 6e 20 77 68 65 6e 0a 69 74 20 68 61 73  tion when.it has
6ea0: 20 32 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 6d   2 or more argum
6eb0: 65 6e 74 73 20 62 75 74 20 63 6f 6e 76 65 72 74  ents but convert
6ec0: 73 20 74 6f 20 61 6e 20 61 67 67 72 65 67 61 74  s to an aggregat
6ed0: 65 20 66 75 6e 63 74 69 6f 6e 20 69 66 20 67 69  e function if gi
6ee0: 76 65 6e 0a 6f 6e 6c 79 20 61 20 73 69 6e 67 6c  ven.only a singl
6ef0: 65 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 74 64 3e  e argument.</td>
6f00: 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64  .</tr>..<tr>.<td
6f10: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c   valign="top" al
6f20: 69 67 6e 3d 22 72 69 67 68 74 22 3e 72 61 6e 64  ign="right">rand
6f30: 6f 6d 28 2a 29 3c 2f 74 64 3e 0a 3c 74 64 20 76  om(*)</td>.<td v
6f40: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74 75  align="top">Retu
6f50: 72 6e 20 61 20 72 61 6e 64 6f 6d 20 69 6e 74 65  rn a random inte
6f60: 67 65 72 20 62 65 74 77 65 65 6e 20 2d 32 31 34  ger between -214
6f70: 37 34 38 33 36 34 38 20 61 6e 64 0a 2b 32 31 34  7483648 and.+214
6f80: 37 34 38 33 36 34 37 2e 3c 2f 74 64 3e 0a 3c 2f  7483647.</td>.</
6f90: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
6fa0: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
6fb0: 3d 22 72 69 67 68 74 22 3e 72 6f 75 6e 64 28 3c  ="right">round(<
6fc0: 69 3e 58 3c 2f 69 3e 29 3c 62 72 3e 72 6f 75 6e  i>X</i>)<br>roun
6fd0: 64 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c  d(<i>X</i>,<i>Y<
6fe0: 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61  /i>)</td>.<td va
6ff0: 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 6f 75 6e 64  lign="top">Round
7000: 20 6f 66 66 20 74 68 65 20 6e 75 6d 62 65 72 20   off the number 
7010: 3c 69 3e 58 3c 2f 69 3e 20 74 6f 20 3c 69 3e 59  <i>X</i> to <i>Y
7020: 3c 2f 69 3e 20 64 69 67 69 74 73 20 74 6f 20 74  </i> digits to t
7030: 68 65 0a 72 69 67 68 74 20 6f 66 20 74 68 65 20  he.right of the 
7040: 64 65 63 69 6d 61 6c 20 70 6f 69 6e 74 2e 20 20  decimal point.  
7050: 49 66 20 74 68 65 20 3c 69 3e 59 3c 2f 69 3e 20  If the <i>Y</i> 
7060: 61 72 67 75 6d 65 6e 74 20 69 73 20 6f 6d 69 74  argument is omit
7070: 74 65 64 2c 20 30 20 69 73 20 0a 61 73 73 75 6d  ted, 0 is .assum
7080: 65 64 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a  ed.</td>.</tr>..
7090: 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  <tr>.<td valign=
70a0: 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67  "top" align="rig
70b0: 68 74 22 3e 73 75 62 73 74 72 28 3c 69 3e 58 3c  ht">substr(<i>X<
70c0: 2f 69 3e 2c 3c 69 3e 59 3c 2f 69 3e 2c 3c 69 3e  /i>,<i>Y</i>,<i>
70d0: 5a 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  Z</i>)</td>.<td 
70e0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
70f0: 75 72 6e 20 61 20 73 75 62 73 74 72 69 6e 67 20  urn a substring 
7100: 6f 66 20 69 6e 70 75 74 20 73 74 72 69 6e 67 20  of input string 
7110: 3c 69 3e 58 3c 2f 69 3e 20 74 68 61 74 20 62 65  <i>X</i> that be
7120: 67 69 6e 73 0a 77 69 74 68 20 74 68 65 20 3c 69  gins.with the <i
7130: 3e 59 3c 2f 69 3e 2d 74 68 20 63 68 61 72 61 63  >Y</i>-th charac
7140: 74 65 72 20 61 6e 64 20 77 68 69 63 68 20 69 73  ter and which is
7150: 20 3c 69 3e 5a 3c 2f 69 3e 20 63 68 61 72 61 63   <i>Z</i> charac
7160: 74 65 72 73 20 6c 6f 6e 67 2e 0a 54 68 65 20 6c  ters long..The l
7170: 65 66 74 2d 6d 6f 73 74 20 63 68 61 72 61 63 74  eft-most charact
7180: 65 72 20 6f 66 20 3c 69 3e 58 3c 2f 69 3e 20 69  er of <i>X</i> i
7190: 73 20 6e 75 6d 62 65 72 20 31 2e 20 20 49 66 20  s number 1.  If 
71a0: 3c 69 3e 59 3c 2f 69 3e 20 69 73 20 6e 65 67 61  <i>Y</i> is nega
71b0: 74 69 76 65 0a 74 68 65 20 74 68 65 20 66 69 72  tive.the the fir
71c0: 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 66 20  st character of 
71d0: 74 68 65 20 73 75 62 73 74 72 69 6e 67 20 69 73  the substring is
71e0: 20 66 6f 75 6e 64 20 62 79 20 63 6f 75 6e 74 69   found by counti
71f0: 6e 67 20 66 72 6f 6d 20 74 68 65 0a 72 69 67 68  ng from the.righ
7200: 74 20 72 61 74 68 65 72 20 74 68 61 6e 20 74 68  t rather than th
7210: 65 20 6c 65 66 74 2e 20 20 49 66 20 53 51 4c 69  e left.  If SQLi
7220: 74 65 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64  te is configured
7230: 20 74 6f 20 73 75 70 70 6f 72 74 20 55 54 46 2d   to support UTF-
7240: 38 2c 0a 74 68 65 6e 20 63 68 61 72 61 63 74 65  8,.then characte
7250: 72 73 20 69 6e 64 69 63 65 73 20 72 65 66 65 72  rs indices refer
7260: 20 74 6f 20 61 63 74 75 61 6c 20 55 54 46 2d 38   to actual UTF-8
7270: 20 63 68 61 72 61 63 74 65 72 73 2c 20 6e 6f 74   characters, not
7280: 20 62 79 74 65 73 2e 3c 2f 74 64 3e 0a 3c 2f 74   bytes.</td>.</t
7290: 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c  r>..<tr>.<td val
72a0: 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d  ign="top" align=
72b0: 22 72 69 67 68 74 22 3e 75 70 70 65 72 28 3c 69  "right">upper(<i
72c0: 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64  >X</i>)</td>.<td
72d0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65   valign="top">Re
72e0: 74 75 72 6e 20 61 20 63 6f 70 79 20 6f 66 20 69  turn a copy of i
72f0: 6e 70 75 74 20 73 74 72 69 6e 67 20 3c 69 3e 58  nput string <i>X
7300: 3c 2f 69 3e 20 63 6f 6e 76 65 72 74 65 64 20 74  </i> converted t
7310: 6f 20 61 6c 6c 0a 75 70 70 65 72 2d 63 61 73 65  o all.upper-case
7320: 20 6c 65 74 74 65 72 73 2e 20 20 54 68 65 20 69   letters.  The i
7330: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
7340: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 75   this function u
7350: 73 65 73 20 74 68 65 20 43 20 6c 69 62 72 61 72  ses the C librar
7360: 79 0a 72 6f 75 74 69 6e 65 20 3c 62 3e 74 6f 75  y.routine <b>tou
7370: 70 70 65 72 28 29 3c 2f 62 3e 20 77 68 69 63 68  pper()</b> which
7380: 20 6d 65 61 6e 73 20 69 74 20 6d 61 79 20 6e 6f   means it may no
7390: 74 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79  t work correctly
73a0: 20 6f 6e 20 0a 55 54 46 2d 38 20 73 74 72 69 6e   on .UTF-8 strin
73b0: 67 73 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c  gs.</td>.</tr>.<
73c0: 2f 74 61 62 6c 65 3e 0a 0a 3c 70 3e 0a 54 68 65  /table>..<p>.The
73d0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 67 67 72 65   following aggre
73e0: 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 61  gate functions a
73f0: 72 65 20 73 75 70 70 6f 72 74 65 64 3a 0a 3c 2f  re supported:.</
7400: 70 3e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72 64 65  p>..<table borde
7410: 72 3d 30 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d  r=0 cellpadding=
7420: 31 30 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c  10>.<tr>.<td val
7430: 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d  ign="top" align=
7440: 22 72 69 67 68 74 22 20 77 69 64 74 68 3d 31 32  "right" width=12
7450: 30 3e 61 76 67 28 3c 69 3e 58 3c 2f 69 3e 29 3c  0>avg(<i>X</i>)<
7460: 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  /td>.<td valign=
7470: 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68 65  "top">Return the
7480: 20 61 76 65 72 61 67 65 20 76 61 6c 75 65 20 6f   average value o
7490: 66 20 61 6c 6c 20 3c 69 3e 58 3c 2f 69 3e 20 77  f all <i>X</i> w
74a0: 69 74 68 69 6e 20 61 20 67 72 6f 75 70 2e 3c 2f  ithin a group.</
74b0: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
74c0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
74d0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 63   align="right">c
74e0: 6f 75 6e 74 28 3c 69 3e 58 3c 2f 69 3e 29 3c 62  ount(<i>X</i>)<b
74f0: 72 3e 63 6f 75 6e 74 28 2a 29 3c 2f 74 64 3e 0a  r>count(*)</td>.
7500: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7510: 3e 54 68 65 20 66 69 72 73 74 20 66 6f 72 6d 20  >The first form 
7520: 72 65 74 75 72 6e 20 61 20 63 6f 75 6e 74 20 6f  return a count o
7530: 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  f the number of 
7540: 74 69 6d 65 73 0a 74 68 61 74 20 3c 69 3e 58 3c  times.that <i>X<
7550: 2f 69 3e 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20  /i> is not NULL 
7560: 69 6e 20 61 20 67 72 6f 75 70 2e 20 20 54 68 65  in a group.  The
7570: 20 73 65 63 6f 6e 64 20 66 6f 72 6d 20 28 77 69   second form (wi
7580: 74 68 20 6e 6f 20 61 72 67 75 6d 65 6e 74 29 0a  th no argument).
7590: 72 65 74 75 72 6e 73 20 74 68 65 20 74 6f 74 61  returns the tota
75a0: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73  l number of rows
75b0: 20 69 6e 20 74 68 65 20 67 72 6f 75 70 2e 3c 2f   in the group.</
75c0: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
75d0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
75e0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d   align="right">m
75f0: 61 78 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64  ax(<i>X</i>)</td
7600: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
7610: 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 6d 61  p">Return the ma
7620: 78 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 61  ximum value of a
7630: 6c 6c 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65  ll values in the
7640: 20 67 72 6f 75 70 2e 0a 54 68 65 20 75 73 75 61   group..The usua
7650: 6c 20 73 6f 72 74 20 6f 72 64 65 72 20 69 73 20  l sort order is 
7660: 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e  used to determin
7670: 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 2e 3c 2f  e the maximum.</
7680: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
7690: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
76a0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d   align="right">m
76b0: 69 6e 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64  in(<i>X</i>)</td
76c0: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
76d0: 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 6d 69  p">Return the mi
76e0: 6e 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 61  nimum value of a
76f0: 6c 6c 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65  ll values in the
7700: 20 67 72 6f 75 70 2e 0a 54 68 65 20 75 73 75 61   group..The usua
7710: 6c 20 73 6f 72 74 20 6f 72 64 65 72 20 69 73 20  l sort order is 
7720: 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e  used to determin
7730: 65 20 74 68 65 20 6d 69 6e 69 6d 75 6d 2e 3c 2f  e the minimum.</
7740: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
7750: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7760: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 73   align="right">s
7770: 75 6d 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64  um(<i>X</i>)</td
7780: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
7790: 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 6e 75  p">Return the nu
77a0: 6d 65 72 69 63 20 73 75 6d 20 6f 66 20 61 6c 6c  meric sum of all
77b0: 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 67   values in the g
77c0: 72 6f 75 70 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e  roup.</td>.</tr>
77d0: 0a 3c 2f 74 61 62 6c 65 3e 0a 7d 0a 0a 53 65 63  .</table>.}..Sec
77e0: 74 69 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73 65  tion INSERT inse
77f0: 72 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  rt..Syntax {sql-
7800: 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e 53  statement} {.INS
7810: 45 52 54 20 5b 4f 52 20 3c 63 6f 6e 66 6c 69 63  ERT [OR <conflic
7820: 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 5d 20 49 4e  t-algorithm>] IN
7830: 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  TO <table-name> 
7840: 5b 28 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 29  [(<column-list>)
7850: 5d 20 56 41 4c 55 45 53 28 3c 76 61 6c 75 65 2d  ] VALUES(<value-
7860: 6c 69 73 74 3e 29 20 7c 0a 49 4e 53 45 52 54 20  list>) |.INSERT 
7870: 5b 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c  [OR <conflict-al
7880: 67 6f 72 69 74 68 6d 3e 5d 20 49 4e 54 4f 20 3c  gorithm>] INTO <
7890: 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 3c 63  table-name> [(<c
78a0: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 29 5d 20 3c 73  olumn-list>)] <s
78b0: 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e  elect-statement>
78c0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
78d0: 65 20 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65  e INSERT stateme
78e0: 6e 74 20 63 6f 6d 65 73 20 69 6e 20 74 77 6f 20  nt comes in two 
78f0: 62 61 73 69 63 20 66 6f 72 6d 73 2e 20 20 54 68  basic forms.  Th
7900: 65 20 66 69 72 73 74 20 66 6f 72 6d 0a 28 77 69  e first form.(wi
7910: 74 68 20 74 68 65 20 22 56 41 4c 55 45 53 22 20  th the "VALUES" 
7920: 6b 65 79 77 6f 72 64 29 20 63 72 65 61 74 65 73  keyword) creates
7930: 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 20 72 6f   a single new ro
7940: 77 20 69 6e 20 61 6e 20 65 78 69 73 74 69 6e 67  w in an existing
7950: 20 74 61 62 6c 65 2e 0a 49 66 20 6e 6f 20 63 6f   table..If no co
7960: 6c 75 6d 6e 2d 6c 69 73 74 20 69 73 20 73 70 65  lumn-list is spe
7970: 63 69 66 69 65 64 20 74 68 65 6e 20 74 68 65 20  cified then the 
7980: 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73  number of values
7990: 20 6d 75 73 74 0a 62 65 20 74 68 65 20 73 61 6d   must.be the sam
79a0: 65 20 61 73 20 74 68 65 20 6e 75 6d 62 65 72 20  e as the number 
79b0: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
79c0: 65 20 74 61 62 6c 65 2e 20 20 49 66 20 61 20 63  e table.  If a c
79d0: 6f 6c 75 6d 6e 2d 6c 69 73 74 0a 69 73 20 73 70  olumn-list.is sp
79e0: 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 74 68  ecified, then th
79f0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75  e number of valu
7a00: 65 73 20 6d 75 73 74 20 6d 61 74 63 68 20 74 68  es must match th
7a10: 65 20 6e 75 6d 62 65 72 20 6f 66 0a 73 70 65 63  e number of.spec
7a20: 69 66 69 65 64 20 63 6f 6c 75 6d 6e 73 2e 20 20  ified columns.  
7a30: 43 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20 74  Columns of the t
7a40: 61 62 6c 65 20 74 68 61 74 20 64 6f 20 6e 6f 74  able that do not
7a50: 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 0a 63   appear in the.c
7a60: 6f 6c 75 6d 6e 20 6c 69 73 74 20 61 72 65 20 66  olumn list are f
7a70: 69 6c 6c 20 77 69 74 68 20 74 68 65 20 64 65 66  ill with the def
7a80: 61 75 6c 74 20 76 61 6c 75 65 2c 20 6f 72 20 77  ault value, or w
7a90: 69 74 68 20 4e 55 4c 4c 20 69 66 20 6e 6f 74 0a  ith NULL if not.
7aa0: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73  default value is
7ab0: 20 73 70 65 63 69 66 69 65 64 2e 0a 3c 2f 70 3e   specified..</p>
7ac0: 0a 0a 3c 70 3e 54 68 65 20 73 65 63 6f 6e 64 20  ..<p>The second 
7ad0: 66 6f 72 6d 20 6f 66 20 74 68 65 20 49 4e 53 45  form of the INSE
7ae0: 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 61 6b  RT statement tak
7af0: 65 73 20 69 74 20 64 61 74 61 20 66 72 6f 6d 20  es it data from 
7b00: 61 0a 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  a.SELECT stateme
7b10: 6e 74 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20  nt.  The number 
7b20: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
7b30: 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 0a  e result of the.
7b40: 53 45 4c 45 43 54 20 6d 75 73 74 20 65 78 61 63  SELECT must exac
7b50: 74 6c 79 20 6d 61 74 63 68 20 74 68 65 20 6e 75  tly match the nu
7b60: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
7b70: 69 6e 20 74 68 65 20 74 61 62 6c 65 20 69 66 0a  in the table if.
7b80: 6e 6f 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 69  no column list i
7b90: 73 20 73 70 65 63 69 66 69 65 64 2c 20 6f 72 20  s specified, or 
7ba0: 69 74 20 6d 75 73 74 20 6d 61 74 63 68 20 74 68  it must match th
7bb0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  e number of colu
7bc0: 6d 6e 73 0a 6e 61 6d 65 20 69 6e 20 74 68 65 20  mns.name in the 
7bd0: 63 6f 6c 75 6d 6e 20 6c 69 73 74 2e 20 20 41 20  column list.  A 
7be0: 6e 65 77 20 65 6e 74 72 79 20 69 73 20 6d 61 64  new entry is mad
7bf0: 65 20 69 6e 20 74 68 65 20 74 61 62 6c 65 0a 66  e in the table.f
7c00: 6f 72 20 65 76 65 72 79 20 72 6f 77 20 6f 66 20  or every row of 
7c10: 74 68 65 20 53 45 4c 45 43 54 20 72 65 73 75 6c  the SELECT resul
7c20: 74 2e 20 20 54 68 65 20 53 45 4c 45 43 54 20 6d  t.  The SELECT m
7c30: 61 79 20 62 65 20 73 69 6d 70 6c 65 0a 6f 72 20  ay be simple.or 
7c40: 63 6f 6d 70 6f 75 6e 64 2e 20 20 49 66 20 74 68  compound.  If th
7c50: 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  e SELECT stateme
7c60: 6e 74 20 68 61 73 20 61 6e 20 4f 52 44 45 52 20  nt has an ORDER 
7c70: 42 59 20 63 6c 61 75 73 65 2c 0a 74 68 65 20 4f  BY clause,.the O
7c80: 52 44 45 52 20 42 59 20 69 73 20 69 67 6e 6f 72  RDER BY is ignor
7c90: 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  ed.</p>..<p>The 
7ca0: 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63  optional conflic
7cb0: 74 2d 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20  t-clause allows 
7cc0: 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69 6f  the specificatio
7cd0: 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74  n of an alternat
7ce0: 69 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63  ive.constraint c
7cf0: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
7d00: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20  on algorithm to 
7d10: 75 73 65 20 64 75 72 69 6e 67 20 74 68 69 73 20  use during this 
7d20: 6f 6e 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65  one command..See
7d30: 20 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74   the section tit
7d40: 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f  led.<a href="#co
7d50: 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c  nflict">ON CONFL
7d60: 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69  ICT</a> for addi
7d70: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
7d80: 6f 6e 2e 0a 46 6f 72 20 63 6f 6d 70 61 74 69 62  on..For compatib
7d90: 69 6c 69 74 79 20 77 69 74 68 20 4d 79 53 51 4c  ility with MySQL
7da0: 2c 20 74 68 65 20 70 61 72 73 65 72 20 61 6c 6c  , the parser all
7db0: 6f 77 73 20 74 68 65 20 75 73 65 20 6f 66 20 74  ows the use of t
7dc0: 68 65 0a 73 69 6e 67 6c 65 20 6b 65 79 77 6f 72  he.single keywor
7dd0: 64 20 22 52 45 50 4c 41 43 45 22 20 61 73 20 61  d "REPLACE" as a
7de0: 6e 20 61 6c 69 61 73 20 66 6f 72 20 22 49 4e 53  n alias for "INS
7df0: 45 52 54 20 4f 52 20 52 45 50 4c 41 43 45 22 2e  ERT OR REPLACE".
7e00: 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
7e10: 20 7b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c   {ON CONFLICT cl
7e20: 61 75 73 65 7d 20 63 6f 6e 66 6c 69 63 74 0a 0a  ause} conflict..
7e30: 53 79 6e 74 61 78 20 7b 63 6f 6e 66 6c 69 63 74  Syntax {conflict
7e40: 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f 4e 20 43 4f  -clause} {.ON CO
7e50: 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63 74  NFLICT <conflict
7e60: 2d 61 6c 67 6f 72 69 74 68 6d 3e 0a 7d 20 7b 63  -algorithm>.} {c
7e70: 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68  onflict-algorith
7e80: 6d 7d 20 7b 0a 52 4f 4c 4c 42 41 43 4b 20 7c 20  m} {.ROLLBACK | 
7e90: 41 42 4f 52 54 20 7c 20 46 41 49 4c 20 7c 20 49  ABORT | FAIL | I
7ea0: 47 4e 4f 52 45 20 7c 20 52 45 50 4c 41 43 45 0a  GNORE | REPLACE.
7eb0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
7ec0: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
7ed0: 75 73 65 20 69 73 20 6e 6f 74 20 61 20 73 65 70  use is not a sep
7ee0: 61 72 61 74 65 20 53 51 4c 20 63 6f 6d 6d 61 6e  arate SQL comman
7ef0: 64 2e 20 20 49 74 20 69 73 20 61 0a 6e 6f 6e 2d  d.  It is a.non-
7f00: 73 74 61 6e 64 61 72 64 20 63 6c 61 75 73 65 20  standard clause 
7f10: 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72 20  that can appear 
7f20: 69 6e 20 6d 61 6e 79 20 6f 74 68 65 72 20 53 51  in many other SQ
7f30: 4c 20 63 6f 6d 6d 61 6e 64 73 2e 0a 49 74 20 69  L commands..It i
7f40: 73 20 67 69 76 65 6e 20 69 74 73 20 6f 77 6e 20  s given its own 
7f50: 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 69 73 20  section in this 
7f60: 64 6f 63 75 6d 65 6e 74 20 62 65 63 61 75 73 65  document because
7f70: 20 69 74 20 69 73 20 6e 6f 74 0a 70 61 72 74 20   it is not.part 
7f80: 6f 66 20 73 74 61 6e 64 61 72 64 20 53 51 4c 20  of standard SQL 
7f90: 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 6d 69  and therefore mi
7fa0: 67 68 74 20 6e 6f 74 20 62 65 20 66 61 6d 69 6c  ght not be famil
7fb0: 69 61 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  iar.</p>..<p>The
7fc0: 20 73 79 6e 74 61 78 20 66 6f 72 20 74 68 65 20   syntax for the 
7fd0: 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75  ON CONFLICT clau
7fe0: 73 65 20 69 73 20 61 73 20 73 68 6f 77 6e 20 61  se is as shown a
7ff0: 62 6f 76 65 20 66 6f 72 0a 74 68 65 20 43 52 45  bove for.the CRE
8000: 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54  ATE TABLE, CREAT
8010: 45 20 49 4e 44 45 58 2c 20 61 6e 64 20 42 45 47  E INDEX, and BEG
8020: 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63  IN TRANSACTION c
8030: 6f 6d 6d 61 6e 64 73 2e 0a 46 6f 72 20 74 68 65  ommands..For the
8040: 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20 61   COPY, INSERT, a
8050: 6e 64 20 55 50 44 41 54 45 20 63 6f 6d 6d 61 6e  nd UPDATE comman
8060: 64 73 2c 20 74 68 65 20 6b 65 79 77 6f 72 64 73  ds, the keywords
8070: 0a 22 4f 4e 20 43 4f 4e 46 4c 49 43 54 22 20 61  ."ON CONFLICT" a
8080: 72 65 20 72 65 70 6c 61 63 65 64 20 62 79 20 22  re replaced by "
8090: 4f 52 22 2c 20 74 6f 20 6d 61 6b 65 20 74 68 65  OR", to make the
80a0: 20 73 79 6e 74 61 78 20 73 65 65 6d 20 6d 6f 72   syntax seem mor
80b0: 65 0a 6e 61 74 75 72 61 6c 2e 20 20 42 75 74 20  e.natural.  But 
80c0: 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74  the meaning of t
80d0: 68 65 20 63 6c 61 75 73 65 20 69 73 20 74 68 65  he clause is the
80e0: 20 73 61 6d 65 20 65 69 74 68 65 72 20 77 61 79   same either way
80f0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f 4e  .</p>..<p>The ON
8100: 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65   CONFLICT clause
8110: 20 73 70 65 63 69 66 69 65 73 20 61 6e 20 61 6c   specifies an al
8120: 67 6f 72 69 74 68 6d 20 75 73 65 64 20 74 6f 20  gorithm used to 
8130: 72 65 73 6f 6c 76 65 0a 63 6f 6e 73 74 72 61 69  resolve.constrai
8140: 6e 74 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20 54  nt conflicts.  T
8150: 68 65 72 65 20 61 72 65 20 66 69 76 65 20 63 68  here are five ch
8160: 6f 69 63 65 73 3a 20 52 4f 4c 4c 42 41 43 4b 2c  oices: ROLLBACK,
8170: 20 41 42 4f 52 54 2c 0a 46 41 49 4c 2c 20 49 47   ABORT,.FAIL, IG
8180: 4e 4f 52 45 2c 20 61 6e 64 20 52 45 50 4c 41 43  NORE, and REPLAC
8190: 45 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 61  E. The default a
81a0: 6c 67 6f 72 69 74 68 6d 20 69 73 20 41 42 4f 52  lgorithm is ABOR
81b0: 54 2e 20 20 54 68 69 73 0a 69 73 20 77 68 61 74  T.  This.is what
81c0: 20 74 68 65 79 20 6d 65 61 6e 3a 3c 2f 70 3e 0a   they mean:</p>.
81d0: 0a 3c 64 6c 3e 0a 3c 64 74 3e 3c 62 3e 52 4f 4c  .<dl>.<dt><b>ROL
81e0: 4c 42 41 43 4b 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c  LBACK</b></dt>.<
81f0: 64 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e  dd><p>When a con
8200: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
8210: 6e 20 6f 63 63 75 72 73 2c 20 61 6e 20 69 6d 6d  n occurs, an imm
8220: 65 64 69 61 74 65 20 52 4f 4c 4c 42 41 43 4b 0a  ediate ROLLBACK.
8230: 6f 63 63 75 72 73 2c 20 74 68 75 73 20 65 6e 64  occurs, thus end
8240: 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20  ing the current 
8250: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e 64  transaction, and
8260: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 62 6f   the command abo
8270: 72 74 73 0a 77 69 74 68 20 61 20 72 65 74 75 72  rts.with a retur
8280: 6e 20 63 6f 64 65 20 6f 66 20 53 51 4c 49 54 45  n code of SQLITE
8290: 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20 20 49 66  _CONSTRAINT.  If
82a0: 20 6e 6f 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   no transaction 
82b0: 69 73 0a 61 63 74 69 76 65 20 28 6f 74 68 65 72  is.active (other
82c0: 20 74 68 61 6e 20 74 68 65 20 69 6d 70 6c 69 65   than the implie
82d0: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 68  d transaction th
82e0: 61 74 20 69 73 20 63 72 65 61 74 65 64 20 6f 6e  at is created on
82f0: 20 65 76 65 72 79 0a 63 6f 6d 6d 61 6e 64 29 20   every.command) 
8300: 74 68 65 6e 20 74 68 69 73 20 61 6c 67 6f 72 69  then this algori
8310: 74 68 6d 20 77 6f 72 6b 73 20 74 68 65 20 73 61  thm works the sa
8320: 6d 65 20 61 73 20 41 42 4f 52 54 2e 3c 2f 70 3e  me as ABORT.</p>
8330: 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 41 42  </dd>..<dt><b>AB
8340: 4f 52 54 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64  ORT</b></dt>.<dd
8350: 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74  ><p>When a const
8360: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
8370: 6f 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d  occurs, the comm
8380: 61 6e 64 20 62 61 63 6b 73 20 6f 75 74 0a 61 6e  and backs out.an
8390: 79 20 70 72 69 6f 72 20 63 68 61 6e 67 65 73 20  y prior changes 
83a0: 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 6d 61  it might have ma
83b0: 64 65 20 61 6e 64 20 61 62 6f 72 74 73 20 77 69  de and aborts wi
83c0: 74 68 20 61 20 72 65 74 75 72 6e 20 63 6f 64 65  th a return code
83d0: 0a 6f 66 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54  .of SQLITE_CONST
83e0: 52 41 49 4e 54 2e 20 20 42 75 74 20 6e 6f 20 52  RAINT.  But no R
83f0: 4f 4c 4c 42 41 43 4b 20 69 73 20 65 78 65 63 75  OLLBACK is execu
8400: 74 65 64 20 73 6f 20 63 68 61 6e 67 65 73 0a 66  ted so changes.f
8410: 72 6f 6d 20 70 72 69 6f 72 20 63 6f 6d 6d 61 6e  rom prior comman
8420: 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 73 61  ds within the sa
8430: 6d 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 61  me transaction.a
8440: 72 65 20 70 72 65 73 65 72 76 65 64 2e 20 20 54  re preserved.  T
8450: 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75  his is the defau
8460: 6c 74 20 62 65 68 61 76 69 6f 72 2e 3c 2f 70 3e  lt behavior.</p>
8470: 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 46 41  </dd>..<dt><b>FA
8480: 49 4c 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e  IL</b></dt>.<dd>
8490: 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74 72  <p>When a constr
84a0: 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 6f  aint violation o
84b0: 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d 61  ccurs, the comma
84c0: 6e 64 20 61 62 6f 72 74 73 20 77 69 74 68 20 61  nd aborts with a
84d0: 0a 72 65 74 75 72 6e 20 63 6f 64 65 20 53 51 4c  .return code SQL
84e0: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20  ITE_CONSTRAINT. 
84f0: 20 42 75 74 20 61 6e 79 20 63 68 61 6e 67 65 73   But any changes
8500: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65   to the database
8510: 20 74 68 61 74 0a 74 68 65 20 63 6f 6d 6d 61 6e   that.the comman
8520: 64 20 6d 61 64 65 20 70 72 69 6f 72 20 74 6f 20  d made prior to 
8530: 65 6e 63 6f 75 6e 74 65 72 69 6e 67 20 74 68 65  encountering the
8540: 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c   constraint viol
8550: 61 74 69 6f 6e 0a 61 72 65 20 70 72 65 73 65 72  ation.are preser
8560: 76 65 64 20 61 6e 64 20 61 72 65 20 6e 6f 74 20  ved and are not 
8570: 62 61 63 6b 65 64 20 6f 75 74 2e 20 20 46 6f 72  backed out.  For
8580: 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 6e 20   example, if an 
8590: 55 50 44 41 54 45 0a 73 74 61 74 65 6d 65 6e 74  UPDATE.statement
85a0: 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 20 63   encountered a c
85b0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
85c0: 69 6f 6e 20 6f 6e 20 74 68 65 20 31 30 30 74 68  ion on the 100th
85d0: 20 72 6f 77 20 74 68 61 74 0a 69 74 20 61 74 74   row that.it att
85e0: 65 6d 70 74 73 20 74 6f 20 75 70 64 61 74 65 2c  empts to update,
85f0: 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 74 20   then the first 
8600: 39 39 20 72 6f 77 20 63 68 61 6e 67 65 73 20 61  99 row changes a
8610: 72 65 20 70 72 65 73 65 72 76 65 64 0a 62 75 74  re preserved.but
8620: 20 63 68 61 6e 67 65 73 20 74 6f 20 72 6f 77 73   changes to rows
8630: 20 31 30 30 20 61 6e 64 20 62 65 79 6f 6e 64 20   100 and beyond 
8640: 6e 65 76 65 72 20 6f 63 63 75 72 2e 3c 2f 70 3e  never occur.</p>
8650: 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 49 47  </dd>..<dt><b>IG
8660: 4e 4f 52 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64  NORE</b></dt>.<d
8670: 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73  d><p>When a cons
8680: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e  traint violation
8690: 20 6f 63 63 75 72 73 2c 20 74 68 65 20 6f 6e 65   occurs, the one
86a0: 20 72 6f 77 20 74 68 61 74 20 63 6f 6e 74 61 69   row that contai
86b0: 6e 73 0a 74 68 65 20 63 6f 6e 73 74 72 61 69 6e  ns.the constrain
86c0: 74 20 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 6e  t violation is n
86d0: 6f 74 20 69 6e 73 65 72 74 65 64 20 6f 72 20 63  ot inserted or c
86e0: 68 61 6e 67 65 64 2e 20 20 42 75 74 20 74 68 65  hanged.  But the
86f0: 20 63 6f 6d 6d 61 6e 64 0a 63 6f 6e 74 69 6e 75   command.continu
8700: 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e 6f 72  es executing nor
8710: 6d 61 6c 6c 79 2e 20 20 4f 74 68 65 72 20 72 6f  mally.  Other ro
8720: 77 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66  ws before and af
8730: 74 65 72 20 74 68 65 20 72 6f 77 20 74 68 61 74  ter the row that
8740: 0a 63 6f 6e 74 61 69 6e 65 64 20 74 68 65 20 63  .contained the c
8750: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
8760: 69 6f 6e 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20  ion continue to 
8770: 62 65 20 69 6e 73 65 72 74 65 64 20 6f 72 20 75  be inserted or u
8780: 70 64 61 74 65 64 0a 6e 6f 72 6d 61 6c 6c 79 2e  pdated.normally.
8790: 20 20 4e 6f 20 65 72 72 6f 72 20 69 73 20 72 65    No error is re
87a0: 74 75 72 6e 65 64 2e 3c 2f 70 3e 3c 2f 64 64 3e  turned.</p></dd>
87b0: 0a 0a 3c 64 74 3e 3c 62 3e 52 45 50 4c 41 43 45  ..<dt><b>REPLACE
87c0: 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70  </b></dt>.<dd><p
87d0: 3e 57 68 65 6e 20 61 20 55 4e 49 51 55 45 20 63  >When a UNIQUE c
87e0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
87f0: 69 6f 6e 20 6f 63 63 75 72 73 2c 20 74 68 65 20  ion occurs, the 
8800: 70 72 65 2d 65 78 69 73 74 69 6e 67 20 72 6f 77  pre-existing row
8810: 0a 74 68 61 74 20 69 73 20 63 61 75 73 69 6e 67  .that is causing
8820: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20   the constraint 
8830: 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 72 65 6d  violation is rem
8840: 6f 76 65 64 20 70 72 69 6f 72 20 74 6f 20 69 6e  oved prior to in
8850: 73 65 72 74 69 6e 67 0a 6f 72 20 75 70 64 61 74  serting.or updat
8860: 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20  ing the current 
8870: 72 6f 77 2e 20 20 54 68 75 73 20 74 68 65 20 69  row.  Thus the i
8880: 6e 73 65 72 74 20 6f 72 20 75 70 64 61 74 65 20  nsert or update 
8890: 61 6c 77 61 79 73 20 6f 63 63 75 72 73 2e 0a 54  always occurs..T
88a0: 68 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 74 69  he command conti
88b0: 6e 75 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e  nues executing n
88c0: 6f 72 6d 61 6c 6c 79 2e 20 20 4e 6f 20 65 72 72  ormally.  No err
88d0: 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 2e 3c  or is returned.<
88e0: 2f 70 3e 0a 3c 70 3e 49 66 20 61 20 4e 4f 54 20  /p>.<p>If a NOT 
88f0: 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20  NULL constraint 
8900: 76 69 6f 6c 61 74 69 6f 6e 20 6f 63 63 75 72 73  violation occurs
8910: 2c 20 74 68 65 20 4e 55 4c 4c 20 76 61 6c 75 65  , the NULL value
8920: 20 69 73 20 72 65 70 6c 61 63 65 64 0a 62 79 20   is replaced.by 
8930: 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75  the default valu
8940: 65 20 66 6f 72 20 74 68 61 74 20 63 6f 6c 75 6d  e for that colum
8950: 6e 2e 20 20 49 66 20 74 68 65 20 63 6f 6c 75 6d  n.  If the colum
8960: 6e 20 68 61 73 20 6e 6f 20 64 65 66 61 75 6c 74  n has no default
8970: 0a 76 61 6c 75 65 2c 20 74 68 65 6e 20 74 68 65  .value, then the
8980: 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68 6d   ABORT algorithm
8990: 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 3c 2f   is used.</p>.</
89a0: 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 70 3e 0a 54  dd>.</dl>..<p>.T
89b0: 68 65 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f  he conflict reso
89c0: 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d  lution algorithm
89d0: 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65   can be specifie
89e0: 64 20 69 6e 20 74 68 72 65 65 20 70 6c 61 63 65  d in three place
89f0: 73 2c 0a 69 6e 20 6f 72 64 65 72 20 66 72 6f 6d  s,.in order from
8a00: 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 68 65   lowest to highe
8a10: 73 74 20 70 72 65 63 65 64 65 6e 63 65 3a 0a 3c  st precedence:.<
8a20: 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70  /p>..<ol>.<li><p
8a30: 3e 0a 4f 6e 20 61 20 42 45 47 49 4e 20 54 52 41  >.On a BEGIN TRA
8a40: 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e 64  NSACTION command
8a50: 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69  ..</p></li>..<li
8a60: 3e 3c 70 3e 0a 4f 6e 20 69 6e 64 69 76 69 64 75  ><p>.On individu
8a70: 61 6c 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 77  al constraints w
8a80: 69 74 68 69 6e 20 61 20 43 52 45 41 54 45 20 54  ithin a CREATE T
8a90: 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49  ABLE or CREATE I
8aa0: 4e 44 45 58 0a 73 74 61 74 65 6d 65 6e 74 2e 0a  NDEX.statement..
8ab0: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c  </p></li>..<li><
8ac0: 70 3e 0a 49 6e 20 74 68 65 20 4f 52 20 63 6c 61  p>.In the OR cla
8ad0: 75 73 65 20 6f 66 20 61 20 43 4f 50 59 2c 20 49  use of a COPY, I
8ae0: 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45  NSERT, or UPDATE
8af0: 20 63 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70 3e 3c 2f   command..</p></
8b00: 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54 68  li>.</ol>..<p>Th
8b10: 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63  e algorithm spec
8b20: 69 66 69 65 64 20 69 6e 20 74 68 65 20 4f 52 20  ified in the OR 
8b30: 63 6c 61 75 73 65 20 6f 66 20 61 20 43 4f 50 59  clause of a COPY
8b40: 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44  , INSERT, or UPD
8b50: 41 54 45 0a 6f 76 65 72 72 69 64 65 73 20 61 6e  ATE.overrides an
8b60: 79 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63  y algorithm spec
8b70: 69 66 69 65 64 20 62 79 20 61 20 43 52 45 41 54  ified by a CREAT
8b80: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
8b90: 45 20 49 4e 44 45 58 2e 0a 54 68 65 20 61 6c 67  E INDEX..The alg
8ba0: 6f 72 69 74 68 6d 20 73 70 65 63 69 66 69 65 64  orithm specified
8bb0: 20 77 69 74 68 69 6e 20 61 20 43 52 45 41 54 45   within a CREATE
8bc0: 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45   TABLE or CREATE
8bd0: 20 49 4e 44 45 58 20 77 69 6c 6c 2c 20 69 6e 20   INDEX will, in 
8be0: 74 75 72 6e 2c 0a 6f 76 65 72 72 69 64 65 20 74  turn,.override t
8bf0: 68 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65  he algorithm spe
8c00: 63 69 66 69 65 64 20 62 79 20 61 20 42 45 47 49  cified by a BEGI
8c10: 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63 6f  N TRANSACTION co
8c20: 6d 6d 61 6e 64 2e 0a 49 66 20 6e 6f 20 61 6c 67  mmand..If no alg
8c30: 6f 72 69 74 68 6d 20 69 73 20 73 70 65 63 69 66  orithm is specif
8c40: 69 65 64 20 61 6e 79 77 68 65 72 65 2c 20 74 68  ied anywhere, th
8c50: 65 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68  e ABORT algorith
8c60: 6d 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 0a  m is used.</p>..
8c70: 7d 0a 23 20 3c 70 3e 46 6f 72 20 61 64 64 69 74  }.# <p>For addit
8c80: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
8c90: 6e 2c 20 73 65 65 20 0a 23 20 3c 61 20 68 72 65  n, see .# <a hre
8ca0: 66 3d 22 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c  f="conflict.html
8cb0: 22 3e 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c 3c  ">conflict.html<
8cc0: 2f 61 3e 2e 3c 2f 70 3e 0a 0a 0a 53 65 63 74 69  /a>.</p>...Secti
8cd0: 6f 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d 61  on PRAGMA pragma
8ce0: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
8cf0: 61 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47 4d  atement} {.PRAGM
8d00: 41 20 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c 75  A <name> = <valu
8d10: 65 3e 20 7c 0a 50 52 41 47 4d 41 20 3c 66 75 6e  e> |.PRAGMA <fun
8d20: 63 74 69 6f 6e 3e 28 3c 61 72 67 3e 29 0a 7d 0a  ction>(<arg>).}.
8d30: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 50  .puts {.<p>The P
8d40: 52 41 47 4d 41 20 63 6f 6d 6d 61 6e 64 20 69 73  RAGMA command is
8d50: 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20   used to modify 
8d60: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66  the operation of
8d70: 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72   the SQLite libr
8d80: 61 72 79 2e 0a 54 68 65 20 70 72 61 67 6d 61 20  ary..The pragma 
8d90: 63 6f 6d 6d 61 6e 64 20 69 73 20 65 78 70 65 72  command is exper
8da0: 69 6d 65 6e 74 61 6c 20 61 6e 64 20 73 70 65 63  imental and spec
8db0: 69 66 69 63 20 70 72 61 67 6d 61 20 73 74 61 74  ific pragma stat
8dc0: 65 6d 65 6e 74 73 20 6d 61 79 0a 72 65 6d 6f 76  ements may.remov
8dd0: 65 64 20 6f 72 20 61 64 64 65 64 20 69 6e 20 66  ed or added in f
8de0: 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 20 6f  uture releases o
8df0: 66 20 53 51 4c 69 74 65 2e 20 20 55 73 65 20 74  f SQLite.  Use t
8e00: 68 69 73 20 63 6f 6d 6d 61 6e 64 0a 77 69 74 68  his command.with
8e10: 20 63 61 75 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c   caution.</p>..<
8e20: 70 3e 54 68 65 20 63 75 72 72 65 6e 74 20 69 6d  p>The current im
8e30: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 75 70  plementation sup
8e40: 70 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f 77  ports the follow
8e50: 69 6e 67 20 70 72 61 67 6d 61 73 3a 3c 2f 70 3e  ing pragmas:</p>
8e60: 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62  ..<ul>.<li><p><b
8e70: 3e 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69  >PRAGMA cache_si
8e80: 7a 65 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e 50  ze;.       <br>P
8e90: 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69 7a 65  RAGMA cache_size
8ea0: 20 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d 62 65 72   = </b><i>Number
8eb0: 2d 6f 66 2d 70 61 67 65 73 3c 2f 69 3e 3c 62 3e  -of-pages</i><b>
8ec0: 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70  ;</b></p>.    <p
8ed0: 3e 51 75 65 72 79 20 6f 72 20 63 68 61 6e 67 65  >Query or change
8ee0: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d   the maximum num
8ef0: 62 65 72 20 6f 66 20 64 61 74 61 62 61 73 65 20  ber of database 
8f00: 64 69 73 6b 20 70 61 67 65 73 20 74 68 61 74 20  disk pages that 
8f10: 53 51 4c 69 74 65 0a 20 20 20 20 77 69 6c 6c 20  SQLite.    will 
8f20: 68 6f 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 61  hold in memory a
8f30: 74 20 6f 6e 63 65 2e 20 20 45 61 63 68 20 70 61  t once.  Each pa
8f40: 67 65 20 75 73 65 73 20 61 62 6f 75 74 20 31 2e  ge uses about 1.
8f50: 35 4b 20 6f 66 20 6d 65 6d 6f 72 79 2e 0a 20 20  5K of memory..  
8f60: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 63 61    The default ca
8f70: 63 68 65 20 73 69 7a 65 20 69 73 20 32 30 30 30  che size is 2000
8f80: 2e 20 20 49 66 20 79 6f 75 20 61 72 65 20 64 6f  .  If you are do
8f90: 69 6e 67 20 55 50 44 41 54 45 73 20 6f 72 20 44  ing UPDATEs or D
8fa0: 45 4c 45 54 45 73 0a 20 20 20 20 74 68 61 74 20  ELETEs.    that 
8fb0: 63 68 61 6e 67 65 20 6d 61 6e 79 20 72 6f 77 73  change many rows
8fc0: 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20 61   of a database a
8fd0: 6e 64 20 79 6f 75 20 64 6f 20 6e 6f 74 20 6d 69  nd you do not mi
8fe0: 6e 64 20 69 66 20 53 51 4c 69 74 65 0a 20 20 20  nd if SQLite.   
8ff0: 20 75 73 65 73 20 6d 6f 72 65 20 6d 65 6d 6f 72   uses more memor
9000: 79 2c 20 79 6f 75 20 63 61 6e 20 69 6e 63 72 65  y, you can incre
9010: 61 73 65 20 74 68 65 20 63 61 63 68 65 20 73 69  ase the cache si
9020: 7a 65 20 66 6f 72 20 61 20 70 6f 73 73 69 62 6c  ze for a possibl
9030: 65 20 73 70 65 65 64 0a 20 20 20 20 69 6d 70 72  e speed.    impr
9040: 6f 76 65 6d 65 6e 74 2e 3c 2f 70 3e 0a 20 20 20  ovement.</p>.   
9050: 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 63 68 61   <p>When you cha
9060: 6e 67 65 20 74 68 65 20 63 61 63 68 65 20 73 69  nge the cache si
9070: 7a 65 20 75 73 69 6e 67 20 74 68 65 20 63 61 63  ze using the cac
9080: 68 65 5f 73 69 7a 65 20 70 72 61 67 6d 61 2c 20  he_size pragma, 
9090: 74 68 65 0a 20 20 20 20 63 68 61 6e 67 65 20 6f  the.    change o
90a0: 6e 6c 79 20 65 6e 64 75 72 65 73 20 66 6f 72 20  nly endures for 
90b0: 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 73 73  the current sess
90c0: 69 6f 6e 2e 20 20 54 68 65 20 63 61 63 68 65 20  ion.  The cache 
90d0: 73 69 7a 65 20 72 65 76 65 72 74 73 0a 20 20 20  size reverts.   
90e0: 20 74 6f 20 74 68 65 20 64 65 66 61 75 6c 74 20   to the default 
90f0: 76 61 6c 75 65 20 77 68 65 6e 20 74 68 65 20 64  value when the d
9100: 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65  atabase is close
9110: 64 20 61 6e 64 20 72 65 6f 70 65 6e 65 64 2e 20  d and reopened. 
9120: 20 55 73 65 0a 20 20 20 20 74 68 65 20 3c 62 3e   Use.    the <b>
9130: 64 65 66 61 75 6c 74 5f 63 61 63 68 65 5f 73 69  default_cache_si
9140: 7a 65 3c 2f 62 3e 20 70 72 61 67 6d 61 20 74 6f  ze</b> pragma to
9150: 20 63 68 65 63 6b 20 74 68 65 20 63 61 63 68 65   check the cache
9160: 20 73 69 7a 65 20 70 65 72 6d 61 6e 65 6e 74 6c   size permanentl
9170: 79 0a 20 20 20 20 3c 2f 70 3e 3c 2f 6c 69 3e 0a  y.    </p></li>.
9180: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d  .<li><p><b>PRAGM
9190: 41 20 63 6f 75 6e 74 5f 63 68 61 6e 67 65 73 20  A count_changes 
91a0: 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72  = ON;.       <br
91b0: 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f 63 68  >PRAGMA count_ch
91c0: 61 6e 67 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e  anges = OFF;</b>
91d0: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 57 68 65 6e  </p>.    <p>When
91e0: 20 6f 6e 2c 20 74 68 65 20 43 4f 55 4e 54 5f 43   on, the COUNT_C
91f0: 48 41 4e 47 45 53 20 70 72 61 67 6d 61 20 63 61  HANGES pragma ca
9200: 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62 61 63  uses the callbac
9210: 6b 20 66 75 6e 63 74 69 6f 6e 20 74 6f 0a 20 20  k function to.  
9220: 20 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f 6e 63    be invoked onc
9230: 65 20 66 6f 72 20 65 61 63 68 20 44 45 4c 45 54  e for each DELET
9240: 45 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50  E, INSERT, or UP
9250: 44 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 2e 20  DATE operation. 
9260: 20 54 68 65 0a 20 20 20 20 61 72 67 75 6d 65 6e   The.    argumen
9270: 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20  t is the number 
9280: 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77 65 72  of rows that wer
9290: 65 20 63 68 61 6e 67 65 64 2e 3c 2f 70 3e 0a 20  e changed.</p>. 
92a0: 20 20 20 3c 70 3e 54 68 69 73 20 70 72 61 67 6d     <p>This pragm
92b0: 61 20 6d 61 79 20 62 65 20 72 65 6d 6f 76 65 64  a may be removed
92c0: 20 66 72 6f 6d 20 66 75 74 75 72 65 20 76 65 72   from future ver
92d0: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2e  sions of SQLite.
92e0: 0a 20 20 20 20 43 6f 6e 73 69 64 65 72 20 75 73  .    Consider us
92f0: 69 6e 67 20 74 68 65 20 3c 62 3e 73 71 6c 69 74  ing the <b>sqlit
9300: 65 5f 63 68 61 6e 67 65 73 28 29 3c 2f 62 3e 20  e_changes()</b> 
9310: 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 6e 73  API function ins
9320: 74 65 61 64 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a  tead.</p></li>..
9330: 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41  <li><p><b>PRAGMA
9340: 20 64 65 66 61 75 6c 74 5f 63 61 63 68 65 5f 73   default_cache_s
9350: 69 7a 65 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e  ize;.       <br>
9360: 50 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f 63  PRAGMA default_c
9370: 61 63 68 65 5f 73 69 7a 65 20 3d 20 3c 2f 62 3e  ache_size = </b>
9380: 3c 69 3e 4e 75 6d 62 65 72 2d 6f 66 2d 70 61 67  <i>Number-of-pag
9390: 65 73 3c 2f 69 3e 3c 62 3e 3b 3c 2f 62 3e 3c 2f  es</i><b>;</b></
93a0: 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72 79 20  p>.    <p>Query 
93b0: 6f 72 20 63 68 61 6e 67 65 20 74 68 65 20 6d 61  or change the ma
93c0: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20  ximum number of 
93d0: 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 70 61  database disk pa
93e0: 67 65 73 20 74 68 61 74 20 53 51 4c 69 74 65 0a  ges that SQLite.
93f0: 20 20 20 20 77 69 6c 6c 20 68 6f 6c 64 20 69 6e      will hold in
9400: 20 6d 65 6d 6f 72 79 20 61 74 20 6f 6e 63 65 2e   memory at once.
9410: 20 20 45 61 63 68 20 70 61 67 65 20 75 73 65 73    Each page uses
9420: 20 61 62 6f 75 74 20 31 2e 35 4b 20 6f 66 20 6d   about 1.5K of m
9430: 65 6d 6f 72 79 2e 0a 20 20 20 20 54 68 69 73 20  emory..    This 
9440: 70 72 61 67 6d 61 20 77 6f 72 6b 73 20 6c 69 6b  pragma works lik
9450: 65 20 74 68 65 20 3c 62 3e 63 61 63 68 65 5f 73  e the <b>cache_s
9460: 69 7a 65 3c 2f 62 3e 20 70 72 61 67 6d 61 20 77  ize</b> pragma w
9470: 69 74 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e  ith the addition
9480: 0a 20 20 20 20 66 65 61 74 75 72 65 20 74 68 61  .    feature tha
9490: 74 20 69 74 20 63 68 61 6e 67 65 73 20 74 68 65  t it changes the
94a0: 20 63 61 63 68 65 20 73 69 7a 65 20 70 65 72 73   cache size pers
94b0: 69 73 74 65 6e 74 6c 79 2e 20 20 57 69 74 68 20  istently.  With 
94c0: 74 68 69 73 20 70 72 61 67 6d 61 2c 0a 20 20 20  this pragma,.   
94d0: 20 79 6f 75 20 63 61 6e 20 73 65 74 20 74 68 65   you can set the
94e0: 20 63 61 63 68 65 20 73 69 7a 65 20 6f 6e 63 65   cache size once
94f0: 20 61 6e 64 20 74 68 61 74 20 73 65 74 74 69 6e   and that settin
9500: 67 20 69 73 20 72 65 74 61 69 6e 65 64 20 61 6e  g is retained an
9510: 64 20 72 65 75 73 65 64 0a 20 20 20 20 65 76 65  d reused.    eve
9520: 72 79 74 69 6d 65 20 79 6f 75 20 72 65 6f 70 65  rytime you reope
9530: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 3c  n the database.<
9540: 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70  /p></li>..<li><p
9550: 3e 3c 62 3e 50 52 41 47 4d 41 20 64 65 66 61 75  ><b>PRAGMA defau
9560: 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f 75 73 3b 0a  lt_synchronous;.
9570: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
9580: 41 20 64 65 66 61 75 6c 74 5f 73 79 6e 63 68 72  A default_synchr
9590: 6f 6e 6f 75 73 20 3d 20 4f 4e 3b 0a 20 20 20 20  onous = ON;.    
95a0: 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 64 65     <br>PRAGMA de
95b0: 66 61 75 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f 75  fault_synchronou
95c0: 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e  s = OFF;</b></p>
95d0: 0a 20 20 20 20 3c 70 3e 51 75 65 72 79 20 6f 72  .    <p>Query or
95e0: 20 63 68 61 6e 67 65 20 74 68 65 20 73 65 74 74   change the sett
95f0: 69 6e 67 20 6f 66 20 74 68 65 20 22 73 79 6e 63  ing of the "sync
9600: 68 72 6f 6e 6f 75 73 22 20 66 6c 61 67 20 69 6e  hronous" flag in
9610: 0a 20 20 20 20 74 68 65 20 64 61 74 61 62 61 73  .    the databas
9620: 65 2e 20 20 57 68 65 6e 20 73 79 6e 63 68 72 6f  e.  When synchro
9630: 6e 6f 75 73 20 69 73 20 6f 6e 20 28 74 68 65 20  nous is on (the 
9640: 64 65 66 61 75 6c 74 29 2c 20 74 68 65 20 53 51  default), the SQ
9650: 4c 69 74 65 20 64 61 74 61 62 61 73 65 0a 20 20  Lite database.  
9660: 20 20 65 6e 67 69 6e 65 20 77 69 6c 6c 20 70 61    engine will pa
9670: 75 73 65 20 61 74 20 63 72 69 74 69 63 61 6c 20  use at critical 
9680: 6d 6f 6d 65 6e 74 73 20 74 6f 20 6d 61 6b 65 20  moments to make 
9690: 73 75 72 65 20 74 68 61 74 20 64 61 74 61 20 68  sure that data h
96a0: 61 73 20 61 63 74 75 61 6c 6c 79 0a 20 20 20 20  as actually.    
96b0: 62 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68  be written to th
96c0: 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 2e 20  e disk surface. 
96d0: 20 28 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73   (In other words
96e0: 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68 65  , it invokes the
96f0: 0a 20 20 20 20 65 71 75 69 76 61 6c 65 6e 74 20  .    equivalent 
9700: 6f 66 20 74 68 65 20 3c 62 3e 66 73 79 6e 63 28  of the <b>fsync(
9710: 29 3c 2f 62 3e 20 73 79 73 74 65 6d 20 63 61 6c  )</b> system cal
9720: 6c 2e 29 20 20 49 6e 20 73 79 6e 63 68 72 6f 6e  l.)  In synchron
9730: 6f 75 73 20 6d 6f 64 65 2c 0a 20 20 20 20 61 6e  ous mode,.    an
9740: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65   SQLite database
9750: 20 73 68 6f 75 6c 64 20 62 65 20 66 75 6c 6c 79   should be fully
9760: 20 72 65 63 6f 76 65 72 61 62 6c 65 20 65 76 65   recoverable eve
9770: 6e 20 69 66 20 74 68 65 20 6f 70 65 72 61 74 69  n if the operati
9780: 6e 67 0a 20 20 20 20 73 79 73 74 65 6d 20 63 72  ng.    system cr
9790: 61 73 68 65 73 20 6f 72 20 70 6f 77 65 72 20 69  ashes or power i
97a0: 73 20 69 6e 74 65 72 72 75 70 74 65 64 20 75 6e  s interrupted un
97b0: 65 78 70 65 63 74 65 64 6c 79 2e 20 20 54 68 65  expectedly.  The
97c0: 20 70 65 6e 61 6c 74 79 20 66 6f 72 0a 20 20 20   penalty for.   
97d0: 20 74 68 69 73 20 61 73 73 75 72 61 6e 63 65 20   this assurance 
97e0: 69 73 20 74 68 61 74 20 73 6f 6d 65 20 64 61 74  is that some dat
97f0: 61 62 61 73 65 20 6f 70 65 72 61 74 69 6f 6e 73  abase operations
9800: 20 74 61 6b 65 20 6c 6f 6e 67 65 72 20 62 65 63   take longer bec
9810: 61 75 73 65 20 74 68 65 0a 20 20 20 20 65 6e 67  ause the.    eng
9820: 69 6e 65 20 68 61 73 20 74 6f 20 77 61 69 74 20  ine has to wait 
9830: 6f 6e 20 74 68 65 20 28 72 65 6c 61 74 69 76 65  on the (relative
9840: 6c 79 20 73 6c 6f 77 29 20 64 69 73 6b 20 64 72  ly slow) disk dr
9850: 69 76 65 2e 20 20 54 68 65 20 61 6c 74 65 72 6e  ive.  The altern
9860: 61 74 69 76 65 0a 20 20 20 20 69 73 20 74 6f 20  ative.    is to 
9870: 74 75 72 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 73  turn synchronous
9880: 20 6f 66 66 2e 20 20 57 69 74 68 20 73 79 6e 63   off.  With sync
9890: 68 72 6f 6e 6f 75 73 20 6f 66 66 2c 20 53 51 4c  hronous off, SQL
98a0: 69 74 65 20 63 6f 6e 74 69 6e 75 65 73 0a 20 20  ite continues.  
98b0: 20 20 70 72 6f 63 65 73 73 69 6e 67 20 61 73 20    processing as 
98c0: 73 6f 6f 6e 20 61 73 20 69 74 20 68 61 73 20 68  soon as it has h
98d0: 61 6e 64 65 64 20 64 61 74 61 20 6f 66 66 20 74  anded data off t
98e0: 6f 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20  o the operating 
98f0: 73 79 73 74 65 6d 2e 0a 20 20 20 20 49 66 20 74  system..    If t
9900: 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 72  he application r
9910: 75 6e 6e 69 6e 67 20 53 51 4c 69 74 65 20 63 72  unning SQLite cr
9920: 61 73 68 65 73 2c 20 74 68 65 20 64 61 74 61 20  ashes, the data 
9930: 77 69 6c 6c 20 62 65 20 73 61 66 65 2c 20 62 75  will be safe, bu
9940: 74 0a 20 20 20 20 74 68 65 20 64 61 74 61 62 61  t.    the databa
9950: 73 65 20 63 6f 75 6c 64 20 28 69 6e 20 74 68 65  se could (in the
9960: 6f 72 79 29 20 62 65 63 6f 6d 65 20 63 6f 72 72  ory) become corr
9970: 75 70 74 65 64 20 69 66 20 74 68 65 20 6f 70 65  upted if the ope
9980: 72 61 74 69 6e 67 20 73 79 73 74 65 6d 0a 20 20  rating system.  
9990: 20 20 63 72 61 73 68 65 73 20 6f 72 20 74 68 65    crashes or the
99a0: 20 63 6f 6d 70 75 74 65 72 20 73 75 64 64 65 6e   computer sudden
99b0: 6c 79 20 6c 6f 73 65 73 20 70 6f 77 65 72 2e 20  ly loses power. 
99c0: 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61   On the other ha
99d0: 6e 64 2c 20 73 6f 6d 65 0a 20 20 20 20 6f 70 65  nd, some.    ope
99e0: 72 61 74 69 6f 6e 73 20 61 72 65 20 61 73 20 6d  rations are as m
99f0: 75 63 68 20 61 73 20 35 30 20 6f 72 20 6d 6f 72  uch as 50 or mor
9a00: 65 20 74 69 6d 65 73 20 66 61 73 74 65 72 20 77  e times faster w
9a10: 69 74 68 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20  ith synchronous 
9a20: 6f 66 66 2e 0a 20 20 20 20 3c 2f 70 3e 0a 20 20  off..    </p>.  
9a30: 20 20 3c 70 3e 54 68 69 73 20 70 72 61 67 6d 61    <p>This pragma
9a40: 20 63 68 61 6e 67 65 73 20 74 68 65 20 73 79 6e   changes the syn
9a50: 63 68 72 6f 6e 6f 75 73 20 6d 6f 64 65 20 70 65  chronous mode pe
9a60: 72 73 69 73 74 65 6e 74 6c 79 2e 20 20 4f 6e 63  rsistently.  Onc
9a70: 65 20 63 68 61 6e 67 65 64 2c 0a 20 20 20 20 74  e changed,.    t
9a80: 68 65 20 6d 6f 64 65 20 73 74 61 79 73 20 61 73  he mode stays as
9a90: 20 73 65 74 20 65 76 65 6e 20 69 66 20 74 68 65   set even if the
9aa0: 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f   database is clo
9ab0: 73 65 64 20 61 6e 64 20 72 65 6f 70 65 6e 65 64  sed and reopened
9ac0: 2e 20 20 54 68 65 0a 20 20 20 20 3c 62 3e 73 79  .  The.    <b>sy
9ad0: 6e 63 68 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70 72  nchronous</b> pr
9ae0: 61 67 6d 61 20 64 6f 65 73 20 74 68 65 20 73 61  agma does the sa
9af0: 6d 65 20 74 68 69 6e 67 20 62 75 74 20 6f 6e 6c  me thing but onl
9b00: 79 20 61 70 70 6c 69 65 73 20 74 68 65 20 73 65  y applies the se
9b10: 74 74 69 6e 67 0a 20 20 20 20 74 6f 20 74 68 65  tting.    to the
9b20: 20 63 75 72 72 65 6e 74 20 73 65 73 73 69 6f 6e   current session
9b30: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
9b40: 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65  >PRAGMA empty_re
9b50: 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d  sult_callbacks =
9b60: 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e   ON;.       <br>
9b70: 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65 73  PRAGMA empty_res
9b80: 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d 20  ult_callbacks = 
9b90: 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  OFF;</b></p>.   
9ba0: 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68 65   <p>When on, the
9bb0: 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41   EMPTY_RESULT_CA
9bc0: 4c 4c 42 41 43 4b 53 20 70 72 61 67 6d 61 20 63  LLBACKS pragma c
9bd0: 61 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62 61  auses the callba
9be0: 63 6b 0a 20 20 20 20 66 75 6e 63 74 69 6f 6e 20  ck.    function 
9bf0: 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f 6e  to be invoked on
9c00: 63 65 20 66 6f 72 20 65 61 63 68 20 71 75 65 72  ce for each quer
9c10: 79 20 74 68 61 74 20 68 61 73 20 61 6e 20 65 6d  y that has an em
9c20: 70 74 79 20 72 65 73 75 6c 74 0a 20 20 20 20 73  pty result.    s
9c30: 65 74 2e 20 20 54 68 65 20 74 68 69 72 64 20 22  et.  The third "
9c40: 3c 62 3e 61 72 67 76 3c 2f 62 3e 22 20 70 61 72  <b>argv</b>" par
9c50: 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20 63 61  ameter to the ca
9c60: 6c 6c 62 61 63 6b 20 69 73 20 73 65 74 20 74 6f  llback is set to
9c70: 20 4e 55 4c 4c 0a 20 20 20 20 62 65 63 61 75 73   NULL.    becaus
9c80: 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 61  e there is no da
9c90: 74 61 20 74 6f 20 72 65 70 6f 72 74 2e 20 20 42  ta to report.  B
9ca0: 75 74 20 74 68 65 20 73 65 63 6f 6e 64 20 22 3c  ut the second "<
9cb0: 62 3e 61 72 67 63 3c 2f 62 3e 22 20 61 6e 64 0a  b>argc</b>" and.
9cc0: 20 20 20 20 66 6f 75 72 74 68 20 22 3c 62 3e 63      fourth "<b>c
9cd0: 6f 6c 75 6d 6e 4e 61 6d 65 73 3c 2f 62 3e 22 20  olumnNames</b>" 
9ce0: 70 61 72 61 6d 65 74 65 72 73 20 61 72 65 20 76  parameters are v
9cf0: 61 6c 69 64 20 61 6e 64 20 63 61 6e 20 62 65 20  alid and can be 
9d00: 75 73 65 64 20 74 6f 0a 20 20 20 20 64 65 74 65  used to.    dete
9d10: 72 6d 69 6e 65 20 74 68 65 20 6e 75 6d 62 65 72  rmine the number
9d20: 20 61 6e 64 20 6e 61 6d 65 73 20 6f 66 20 74 68   and names of th
9d30: 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 77  e columns that w
9d40: 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 69  ould have been i
9d50: 6e 0a 20 20 20 20 74 68 65 20 72 65 73 75 6c 74  n.    the result
9d60: 20 73 65 74 20 68 61 64 20 74 68 65 20 73 65 74   set had the set
9d70: 20 6e 6f 74 20 62 65 65 6e 20 65 6d 70 74 79 2e   not been empty.
9d80: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
9d90: 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f 6c 75  PRAGMA full_colu
9da0: 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 4e 3b 0a 20  mn_names = ON;. 
9db0: 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41        <br>PRAGMA
9dc0: 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d   full_column_nam
9dd0: 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70  es = OFF;</b></p
9de0: 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f 6c  >.    <p>The col
9df0: 75 6d 6e 20 6e 61 6d 65 73 20 72 65 70 6f 72 74  umn names report
9e00: 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65 20  ed in an SQLite 
9e10: 63 61 6c 6c 62 61 63 6b 20 61 72 65 20 6e 6f 72  callback are nor
9e20: 6d 61 6c 6c 79 20 6a 75 73 74 0a 20 20 20 20 74  mally just.    t
9e30: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63  he name of the c
9e40: 6f 6c 75 6d 6e 20 69 74 73 65 6c 66 2c 20 65 78  olumn itself, ex
9e50: 63 65 70 74 20 66 6f 72 20 6a 6f 69 6e 73 20 77  cept for joins w
9e60: 68 65 6e 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d  hen "TABLE.COLUM
9e70: 4e 22 0a 20 20 20 20 69 73 20 75 73 65 64 2e 20  N".    is used. 
9e80: 20 42 75 74 20 77 68 65 6e 20 66 75 6c 6c 5f 63   But when full_c
9e90: 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 69 73 20 74  olumn_names is t
9ea0: 75 72 6e 65 64 20 6f 6e 2c 20 63 6f 6c 75 6d 6e  urned on, column
9eb0: 20 6e 61 6d 65 73 20 61 72 65 0a 20 20 20 20 61   names are.    a
9ec0: 6c 77 61 79 73 20 72 65 70 6f 72 74 65 64 20 61  lways reported a
9ed0: 73 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 22  s "TABLE.COLUMN"
9ee0: 20 65 76 65 6e 20 66 6f 72 20 73 69 6d 70 6c 65   even for simple
9ef0: 20 71 75 65 72 69 65 73 2e 3c 2f 70 3e 3c 2f 6c   queries.</p></l
9f00: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52  i>..<li><p><b>PR
9f10: 41 47 4d 41 20 69 6e 64 65 78 5f 69 6e 66 6f 28  AGMA index_info(
9f20: 3c 2f 62 3e 3c 69 3e 69 6e 64 65 78 2d 6e 61 6d  </b><i>index-nam
9f30: 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f  e</i><b>);</b></
9f40: 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61  p>.    <p>For ea
9f50: 63 68 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74  ch column that t
9f60: 68 65 20 6e 61 6d 65 64 20 69 6e 64 65 78 20 72  he named index r
9f70: 65 66 65 72 65 6e 63 65 73 2c 20 69 6e 76 6f 6b  eferences, invok
9f80: 65 20 74 68 65 20 0a 20 20 20 20 63 61 6c 6c 62  e the .    callb
9f90: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20  ack function.   
9fa0: 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72   once with infor
9fb0: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61  mation about tha
9fc0: 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64  t column, includ
9fd0: 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e  ing the column n
9fe0: 61 6d 65 2c 0a 20 20 20 20 61 6e 64 20 74 68 65  ame,.    and the
9ff0: 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 2e 3c   column number.<
a000: 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50  /p>..<li><p><b>P
a010: 52 41 47 4d 41 20 69 6e 64 65 78 5f 6c 69 73 74  RAGMA index_list
a020: 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61  (</b><i>table-na
a030: 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c  me</i><b>);</b><
a040: 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65  /p>.    <p>For e
a050: 61 63 68 20 69 6e 64 65 78 20 6f 6e 20 74 68 65  ach index on the
a060: 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e   named table, in
a070: 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63  voke the callbac
a080: 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f  k function.    o
a090: 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61  nce with informa
a0a0: 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20  tion about that 
a0b0: 69 6e 64 65 78 2e 20 20 41 72 67 75 6d 65 6e 74  index.  Argument
a0c0: 73 20 69 6e 63 6c 75 64 65 20 74 68 65 0a 20 20  s include the.  
a0d0: 20 20 69 6e 64 65 78 20 6e 61 6d 65 20 61 6e 64    index name and
a0e0: 20 61 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 63   a flag to indic
a0f0: 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e  ate whether or n
a100: 6f 74 20 74 68 65 20 69 6e 64 65 78 20 6d 75 73  ot the index mus
a110: 74 20 62 65 0a 20 20 20 20 75 6e 69 71 75 65 2e  t be.    unique.
a120: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
a130: 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72  PRAGMA parser_tr
a140: 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41  ace = ON;<br>PRA
a150: 47 4d 41 20 70 61 72 73 65 72 5f 74 72 61 63 65  GMA parser_trace
a160: 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a   = OFF;</b></p>.
a170: 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61 63      <p>Turn trac
a180: 69 6e 67 20 6f 66 20 74 68 65 20 53 51 4c 20 70  ing of the SQL p
a190: 61 72 73 65 72 20 69 6e 73 69 64 65 20 6f 66 20  arser inside of 
a1a0: 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20 6c  the.    SQLite l
a1b0: 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f 66  ibrary on and of
a1c0: 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64  f.  This is used
a1d0: 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e 0a   for debugging..
a1e0: 20 20 20 20 54 68 69 73 20 6f 6e 6c 79 20 77 6f      This only wo
a1f0: 72 6b 73 20 69 66 20 74 68 65 20 6c 69 62 72 61  rks if the libra
a200: 72 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 77  ry is compiled w
a210: 69 74 68 6f 75 74 20 74 68 65 20 4e 44 45 42 55  ithout the NDEBU
a220: 47 20 6d 61 63 72 6f 2e 0a 20 20 20 20 3c 2f 70  G macro..    </p
a230: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c  ></li>..<li><p><
a240: 62 3e 50 52 41 47 4d 41 20 69 6e 74 65 67 72 69  b>PRAGMA integri
a250: 74 79 5f 63 68 65 63 6b 3b 3c 2f 62 3e 3c 2f 70  ty_check;</b></p
a260: 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f 6d  >.    <p>The com
a270: 6d 61 6e 64 20 64 6f 65 73 20 61 6e 20 69 6e 74  mand does an int
a280: 65 67 72 69 74 79 20 63 68 65 63 6b 20 6f 66 20  egrity check of 
a290: 74 68 65 20 65 6e 74 69 72 65 20 64 61 74 61 62  the entire datab
a2a0: 61 73 65 2e 20 20 49 74 0a 20 20 20 20 6c 6f 6f  ase.  It.    loo
a2b0: 6b 73 20 66 6f 72 20 6f 75 74 2d 6f 66 2d 6f 72  ks for out-of-or
a2c0: 64 65 72 20 72 65 63 6f 72 64 73 2c 20 6d 69 73  der records, mis
a2d0: 73 69 6e 67 20 70 61 67 65 73 2c 20 61 6e 64 20  sing pages, and 
a2e0: 6d 61 6c 66 6f 72 6d 65 64 20 72 65 63 6f 72 64  malformed record
a2f0: 73 2e 0a 20 20 20 20 49 66 20 61 6e 79 20 70 72  s..    If any pr
a300: 6f 62 6c 65 6d 73 20 61 72 65 20 66 6f 75 6e 64  oblems are found
a310: 2c 20 74 68 65 6e 20 61 20 73 69 6e 67 6c 65 20  , then a single 
a320: 73 74 72 69 6e 67 20 69 73 20 72 65 74 75 72 6e  string is return
a330: 65 64 20 77 68 69 63 68 20 69 73 0a 20 20 20 20  ed which is.    
a340: 61 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66  a description of
a350: 20 61 6c 6c 20 70 72 6f 62 6c 65 6d 73 2e 20 20   all problems.  
a360: 49 66 20 65 76 65 72 79 74 68 69 6e 67 20 69 73  If everything is
a370: 20 69 6e 20 6f 72 64 65 72 2c 20 22 6f 6b 22 20   in order, "ok" 
a380: 69 73 0a 20 20 20 20 72 65 74 75 72 6e 65 64 2e  is.    returned.
a390: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
a3a0: 50 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f  PRAGMA synchrono
a3b0: 75 73 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e 50  us;.       <br>P
a3c0: 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75  RAGMA synchronou
a3d0: 73 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c  s = ON;.       <
a3e0: 62 72 3e 50 52 41 47 4d 41 20 73 79 6e 63 68 72  br>PRAGMA synchr
a3f0: 6f 6e 6f 75 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e  onous = OFF;</b>
a400: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72  </p>.    <p>Quer
a410: 79 20 6f 72 20 63 68 61 6e 67 65 20 74 68 65 20  y or change the 
a420: 73 65 74 74 69 6e 67 20 6f 66 20 74 68 65 20 22  setting of the "
a430: 73 79 6e 63 68 72 6f 6e 6f 75 73 22 20 66 6c 61  synchronous" fla
a440: 67 20 69 6e 0a 20 20 20 20 74 68 65 20 64 61 74  g in.    the dat
a450: 61 62 61 73 65 20 66 6f 72 20 74 68 65 20 64 75  abase for the du
a460: 72 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63 75  ration of the cu
a470: 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 63  rrent database c
a480: 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 54 68 65 20  onnect..    The 
a490: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 66 6c 61 67  synchronous flag
a4a0: 20 72 65 76 65 72 74 73 20 74 6f 20 69 74 73 20   reverts to its 
a4b0: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 77 68  default value wh
a4c0: 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  en the database.
a4d0: 20 20 20 20 69 73 20 63 6c 6f 73 65 64 20 61 6e      is closed an
a4e0: 64 20 72 65 6f 70 65 6e 65 64 2e 20 20 46 6f 72  d reopened.  For
a4f0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   additional info
a500: 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 73  rmation on the s
a510: 79 6e 63 68 72 6f 6e 6f 75 73 0a 20 20 20 20 66  ynchronous.    f
a520: 6c 61 67 2c 20 73 65 65 20 74 68 65 20 64 65 73  lag, see the des
a530: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20  cription of the 
a540: 3c 62 3e 64 65 66 61 75 6c 74 5f 73 79 6e 63 68  <b>default_synch
a550: 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70 72 61 67 6d  ronous</b> pragm
a560: 61 2e 3c 2f 70 3e 0a 20 20 20 20 3c 2f 6c 69 3e  a.</p>.    </li>
a570: 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47  ..<li><p><b>PRAG
a580: 4d 41 20 74 61 62 6c 65 5f 69 6e 66 6f 28 3c 2f  MA table_info(</
a590: 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61 6d 65 3c  b><i>table-name<
a5a0: 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e  /i><b>);</b></p>
a5b0: 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61 63 68  .    <p>For each
a5c0: 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 6e   column in the n
a5d0: 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e 76 6f  amed table, invo
a5e0: 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20  ke the callback 
a5f0: 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f 6e 63  function.    onc
a600: 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69  e with informati
a610: 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20 63 6f  on about that co
a620: 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20  lumn, including 
a630: 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 2c  the column name,
a640: 0a 20 20 20 20 64 61 74 61 20 74 79 70 65 2c 20  .    data type, 
a650: 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74  whether or not t
a660: 68 65 20 63 6f 6c 75 6d 6e 20 63 61 6e 20 62 65  he column can be
a670: 20 4e 55 4c 4c 2c 20 61 6e 64 20 74 68 65 20 64   NULL, and the d
a680: 65 66 61 75 6c 74 0a 20 20 20 20 76 61 6c 75 65  efault.    value
a690: 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 2e   for the column.
a6a0: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
a6b0: 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61 63  PRAGMA vdbe_trac
a6c0: 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41 47 4d  e = ON;<br>PRAGM
a6d0: 41 20 76 64 62 65 5f 74 72 61 63 65 20 3d 20 4f  A vdbe_trace = O
a6e0: 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20  FF;</b></p>.    
a6f0: 3c 70 3e 54 75 72 6e 20 74 72 61 63 69 6e 67 20  <p>Turn tracing 
a700: 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 64  of the virtual d
a710: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 69  atabase engine i
a720: 6e 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20 20  nside of the.   
a730: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
a740: 6f 6e 20 61 6e 64 20 6f 66 66 2e 20 20 54 68 69  on and off.  Thi
a750: 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 64 65  s is used for de
a760: 62 75 67 67 69 6e 67 2e 3c 2f 70 3e 3c 2f 6c 69  bugging.</p></li
a770: 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 4e 6f 20 65  >.</ul>..<p>No e
a780: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73 20  rror message is 
a790: 67 65 6e 65 72 61 74 65 64 20 69 66 20 61 6e 20  generated if an 
a7a0: 75 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 20 69  unknown pragma i
a7b0: 73 20 69 73 73 75 65 64 2e 0a 55 6e 6b 6e 6f 77  s issued..Unknow
a7c0: 6e 20 70 72 61 67 6d 61 73 20 61 72 65 20 69 67  n pragmas are ig
a7d0: 6e 6f 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65  nored.</p>.}..Se
a7e0: 63 74 69 6f 6e 20 52 45 50 4c 41 43 45 20 72 65  ction REPLACE re
a7f0: 70 6c 61 63 65 0a 0a 53 79 6e 74 61 78 20 7b 73  place..Syntax {s
a800: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
a810: 52 45 50 4c 41 43 45 20 49 4e 54 4f 20 3c 74 61  REPLACE INTO <ta
a820: 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63 6f  ble-name> [( <co
a830: 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 56 41  lumn-list> )] VA
a840: 4c 55 45 53 20 28 20 3c 76 61 6c 75 65 2d 6c 69  LUES ( <value-li
a850: 73 74 3e 20 29 20 7c 0a 52 45 50 4c 41 43 45 20  st> ) |.REPLACE 
a860: 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d 65  INTO <table-name
a870: 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73  > [( <column-lis
a880: 74 3e 20 29 5d 20 3c 73 65 6c 65 63 74 2d 73 74  t> )] <select-st
a890: 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73  atement>.}..puts
a8a0: 20 7b 0a 3c 70 3e 54 68 65 20 52 45 50 4c 41 43   {.<p>The REPLAC
a8b0: 45 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e 20  E command is an 
a8c0: 61 6c 69 61 73 20 66 6f 72 20 74 68 65 20 22 49  alias for the "I
a8d0: 4e 53 45 52 54 20 4f 52 20 52 45 50 4c 41 43 45  NSERT OR REPLACE
a8e0: 22 20 76 61 72 69 61 6e 74 0a 6f 66 20 74 68 65  " variant.of the
a8f0: 20 3c 61 20 68 72 65 66 3d 22 23 69 6e 73 65 72   <a href="#inser
a900: 74 22 3e 49 4e 53 45 52 54 20 63 6f 6d 6d 61 6e  t">INSERT comman
a910: 64 3c 2f 61 3e 2e 20 20 54 68 69 73 20 61 6c 69  d</a>.  This ali
a920: 61 73 20 69 73 20 70 72 6f 76 69 64 65 64 20 66  as is provided f
a930: 6f 72 0a 63 6f 6d 70 61 74 69 62 69 6c 69 74 79  or.compatibility
a940: 20 77 69 74 68 20 4d 79 53 51 4c 2e 20 20 53 65   with MySQL.  Se
a950: 65 20 74 68 65 20 0a 3c 61 20 68 72 65 66 3d 22  e the .<a href="
a960: 23 69 6e 73 65 72 74 22 3e 49 4e 53 45 52 54 20  #insert">INSERT 
a970: 63 6f 6d 6d 61 6e 64 3c 2f 61 3e 20 64 6f 63 75  command</a> docu
a980: 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61 64  mentation for ad
a990: 64 69 74 69 6f 6e 61 6c 0a 69 6e 66 6f 72 6d 61  ditional.informa
a9a0: 74 69 6f 6e 2e 3c 2f 70 3e 20 20 0a 7d 0a 0a 53  tion.</p>  .}..S
a9b0: 65 63 74 69 6f 6e 20 53 45 4c 45 43 54 20 73 65  ection SELECT se
a9c0: 6c 65 63 74 0a 0a 53 79 6e 74 61 78 20 7b 73 71  lect..Syntax {sq
a9d0: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 53  l-statement} {.S
a9e0: 45 4c 45 43 54 20 3c 72 65 73 75 6c 74 3e 20 5b  ELECT <result> [
a9f0: 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6c 69 73 74  FROM <table-list
aa00: 3e 5d 0a 5b 57 48 45 52 45 20 3c 65 78 70 72 3e  >].[WHERE <expr>
aa10: 5d 0a 5b 47 52 4f 55 50 20 42 59 20 3c 65 78 70  ].[GROUP BY <exp
aa20: 72 2d 6c 69 73 74 3e 5d 0a 5b 48 41 56 49 4e 47  r-list>].[HAVING
aa30: 20 3c 65 78 70 72 3e 5d 0a 5b 3c 63 6f 6d 70 6f   <expr>].[<compo
aa40: 75 6e 64 2d 6f 70 3e 20 3c 73 65 6c 65 63 74 3e  und-op> <select>
aa50: 5d 2a 0a 5b 4f 52 44 45 52 20 42 59 20 3c 73 6f  ]*.[ORDER BY <so
aa60: 72 74 2d 65 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b  rt-expr-list>].[
aa70: 4c 49 4d 49 54 20 3c 69 6e 74 65 67 65 72 3e 20  LIMIT <integer> 
aa80: 5b 4f 46 46 53 45 54 20 3c 69 6e 74 65 67 65 72  [OFFSET <integer
aa90: 3e 5d 5d 0a 7d 20 7b 72 65 73 75 6c 74 7d 20 7b  >]].} {result} {
aaa0: 0a 3c 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e 3e  .<result-column>
aab0: 20 5b 2c 20 3c 72 65 73 75 6c 74 2d 63 6f 6c 75   [, <result-colu
aac0: 6d 6e 3e 5d 2a 0a 7d 20 7b 72 65 73 75 6c 74 2d  mn>]*.} {result-
aad0: 63 6f 6c 75 6d 6e 7d 20 7b 0a 53 54 41 52 20 7c  column} {.STAR |
aae0: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 2e 20   <table-name> . 
aaf0: 53 54 41 52 20 7c 20 3c 65 78 70 72 3e 20 5b 20  STAR | <expr> [ 
ab00: 5b 41 53 5d 20 3c 73 74 72 69 6e 67 3e 20 5d 0a  [AS] <string> ].
ab10: 7d 20 7b 74 61 62 6c 65 2d 6c 69 73 74 7d 20 7b  } {table-list} {
ab20: 0a 3c 74 61 62 6c 65 3e 20 5b 3c 6a 6f 69 6e 2d  .<table> [<join-
ab30: 6f 70 3e 20 3c 74 61 62 6c 65 3e 20 3c 6a 6f 69  op> <table> <joi
ab40: 6e 2d 61 72 67 73 3e 5d 2a 0a 7d 20 7b 74 61 62  n-args>]*.} {tab
ab50: 6c 65 7d 20 7b 0a 3c 74 61 62 6c 65 2d 6e 61 6d  le} {.<table-nam
ab60: 65 3e 20 5b 41 53 20 3c 61 6c 69 61 73 3e 5d 20  e> [AS <alias>] 
ab70: 7c 0a 28 20 3c 73 65 6c 65 63 74 3e 20 29 20 5b  |.( <select> ) [
ab80: 41 53 20 3c 61 6c 69 61 73 3e 5d 0a 7d 20 7b 6a  AS <alias>].} {j
ab90: 6f 69 6e 2d 6f 70 7d 20 7b 0a 2c 20 7c 20 5b 4e  oin-op} {., | [N
aba0: 41 54 55 52 41 4c 5d 20 5b 4c 45 46 54 20 7c 20  ATURAL] [LEFT | 
abb0: 52 49 47 48 54 20 7c 20 46 55 4c 4c 5d 20 5b 4f  RIGHT | FULL] [O
abc0: 55 54 45 52 20 7c 20 49 4e 4e 45 52 5d 20 4a 4f  UTER | INNER] JO
abd0: 49 4e 0a 7d 20 7b 6a 6f 69 6e 2d 61 72 67 73 7d  IN.} {join-args}
abe0: 20 7b 0a 5b 4f 4e 20 3c 65 78 70 72 3e 5d 20 5b   {.[ON <expr>] [
abf0: 55 53 49 4e 47 20 28 20 3c 69 64 2d 6c 69 73 74  USING ( <id-list
ac00: 3e 20 29 5d 0a 7d 20 7b 73 6f 72 74 2d 65 78 70  > )].} {sort-exp
ac10: 72 2d 6c 69 73 74 7d 20 7b 0a 3c 65 78 70 72 3e  r-list} {.<expr>
ac20: 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20   [<sort-order>] 
ac30: 5b 2c 20 3c 65 78 70 72 3e 20 5b 3c 73 6f 72 74  [, <expr> [<sort
ac40: 2d 6f 72 64 65 72 3e 5d 5d 2a 0a 7d 20 7b 73 6f  -order>]]*.} {so
ac50: 72 74 2d 6f 72 64 65 72 7d 20 7b 0a 41 53 43 20  rt-order} {.ASC 
ac60: 7c 20 44 45 53 43 0a 7d 20 7b 63 6f 6d 70 6f 75  | DESC.} {compou
ac70: 6e 64 5f 6f 70 7d 20 7b 0a 55 4e 49 4f 4e 20 7c  nd_op} {.UNION |
ac80: 20 55 4e 49 4f 4e 20 41 4c 4c 20 7c 20 49 4e 54   UNION ALL | INT
ac90: 45 52 53 45 43 54 20 7c 20 45 58 43 45 50 54 0a  ERSECT | EXCEPT.
aca0: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
acb0: 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e   SELECT statemen
acc0: 74 20 69 73 20 75 73 65 64 20 74 6f 20 71 75 65  t is used to que
acd0: 72 79 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  ry the database.
ace0: 20 20 54 68 65 0a 72 65 73 75 6c 74 20 6f 66 20    The.result of 
acf0: 61 20 53 45 4c 45 43 54 20 69 73 20 7a 65 72 6f  a SELECT is zero
ad00: 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f 66   or more rows of
ad10: 20 64 61 74 61 20 77 68 65 72 65 20 65 61 63 68   data where each
ad20: 20 72 6f 77 0a 68 61 73 20 61 20 66 69 78 65 64   row.has a fixed
ad30: 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d   number of colum
ad40: 6e 73 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20  ns.  The number 
ad50: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
ad60: 65 0a 72 65 73 75 6c 74 20 69 73 20 73 70 65 63  e.result is spec
ad70: 69 66 69 65 64 20 62 79 20 74 68 65 20 65 78 70  ified by the exp
ad80: 72 65 73 73 69 6f 6e 20 6c 69 73 74 20 69 6e 20  ression list in 
ad90: 62 65 74 77 65 65 6e 20 74 68 65 0a 53 45 4c 45  between the.SELE
ada0: 43 54 20 61 6e 64 20 46 52 4f 4d 20 6b 65 79 77  CT and FROM keyw
adb0: 6f 72 64 73 2e 20 20 41 6e 79 20 61 72 62 69 74  ords.  Any arbit
adc0: 72 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e 20  rary expression 
add0: 63 61 6e 20 62 65 20 75 73 65 64 0a 61 73 20 61  can be used.as a
ade0: 20 72 65 73 75 6c 74 2e 20 20 49 66 20 61 20 72   result.  If a r
adf0: 65 73 75 6c 74 20 65 78 70 72 65 73 73 69 6f 6e  esult expression
ae00: 20 69 73 20 7d 0a 70 75 74 73 20 22 5b 4f 70 65   is }.puts "[Ope
ae10: 72 61 74 6f 72 20 2a 5d 20 74 68 65 6e 20 61 6c  rator *] then al
ae20: 6c 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6c 6c  l columns of all
ae30: 20 74 61 62 6c 65 73 20 61 72 65 20 73 75 62 73   tables are subs
ae40: 74 69 74 75 74 65 64 22 0a 70 75 74 73 20 7b 66  tituted".puts {f
ae50: 6f 72 20 74 68 61 74 20 6f 6e 65 20 65 78 70 72  or that one expr
ae60: 65 73 73 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e  ession.</p>..<p>
ae70: 54 68 65 20 71 75 65 72 79 20 69 73 20 65 78 65  The query is exe
ae80: 63 75 74 65 64 20 61 67 61 69 6e 20 6f 6e 65 20  cuted again one 
ae90: 6f 72 20 6d 6f 72 65 20 74 61 62 6c 65 73 20 73  or more tables s
aea0: 70 65 63 69 66 69 65 64 20 61 66 74 65 72 0a 74  pecified after.t
aeb0: 68 65 20 46 52 4f 4d 20 6b 65 79 77 6f 72 64 2e  he FROM keyword.
aec0: 20 20 49 66 20 6d 75 6c 74 69 70 6c 65 20 74 61    If multiple ta
aed0: 62 6c 65 73 20 6e 61 6d 65 73 20 61 72 65 20 73  bles names are s
aee0: 65 70 61 72 61 74 65 64 20 62 79 20 63 6f 6d 6d  eparated by comm
aef0: 61 73 2c 0a 74 68 65 6e 20 74 68 65 20 71 75 65  as,.then the que
af00: 72 79 20 69 73 20 61 67 61 69 6e 73 74 20 74 68  ry is against th
af10: 65 20 63 72 6f 73 73 20 6a 6f 69 6e 20 6f 66 20  e cross join of 
af20: 74 68 65 20 76 61 72 69 6f 75 73 20 74 61 62 6c  the various tabl
af30: 65 73 2e 0a 54 68 65 20 66 75 6c 6c 20 53 51 4c  es..The full SQL
af40: 2d 39 32 20 6a 6f 69 6e 20 73 79 6e 74 61 78 20  -92 join syntax 
af50: 63 61 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64  can also be used
af60: 20 74 6f 20 73 70 65 63 69 66 79 20 6a 6f 69 6e   to specify join
af70: 73 2e 0a 41 20 73 75 62 2d 71 75 65 72 79 0a 69  s..A sub-query.i
af80: 6e 20 70 61 72 65 6e 74 68 65 73 65 73 20 6d 61  n parentheses ma
af90: 79 20 62 65 20 73 75 62 73 74 69 74 75 74 65 64  y be substituted
afa0: 20 66 6f 72 20 61 6e 79 20 74 61 62 6c 65 20 6e   for any table n
afb0: 61 6d 65 20 69 6e 20 74 68 65 20 46 52 4f 4d 20  ame in the FROM 
afc0: 63 6c 61 75 73 65 2e 0a 54 68 65 20 65 6e 74 69  clause..The enti
afd0: 72 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 6d  re FROM clause m
afe0: 61 79 20 62 65 20 6f 6d 69 74 74 65 64 2c 20 69  ay be omitted, i
aff0: 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65  n which case the
b000: 20 72 65 73 75 6c 74 20 69 73 20 61 0a 73 69 6e   result is a.sin
b010: 67 6c 65 20 72 6f 77 20 63 6f 6e 73 69 73 74 69  gle row consisti
b020: 6e 67 20 6f 66 20 74 68 65 20 76 61 6c 75 65 73  ng of the values
b030: 20 6f 66 20 74 68 65 20 65 78 70 72 65 73 73 69   of the expressi
b040: 6f 6e 20 6c 69 73 74 2e 0a 3c 2f 70 3e 0a 0a 3c  on list..</p>..<
b050: 70 3e 54 68 65 20 57 48 45 52 45 20 63 6c 61 75  p>The WHERE clau
b060: 73 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74  se can be used t
b070: 6f 20 6c 69 6d 69 74 20 74 68 65 20 6e 75 6d 62  o limit the numb
b080: 65 72 20 6f 66 20 72 6f 77 73 20 6f 76 65 72 0a  er of rows over.
b090: 77 68 69 63 68 20 74 68 65 20 71 75 65 72 79 20  which the query 
b0a0: 6f 70 65 72 61 74 65 73 2e 20 20 49 6e 20 74 68  operates.  In th
b0b0: 65 20 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d  e current implem
b0c0: 65 6e 74 61 74 69 6f 6e 2c 0a 69 6e 64 69 63 65  entation,.indice
b0d0: 73 20 77 69 6c 6c 20 6f 6e 6c 79 20 62 65 20 75  s will only be u
b0e0: 73 65 64 20 74 6f 0a 6f 70 74 69 6d 69 7a 65 20  sed to.optimize 
b0f0: 74 68 65 20 71 75 65 72 79 20 69 66 20 57 48 45  the query if WHE
b100: 52 45 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f  RE expression co
b110: 6e 74 61 69 6e 73 20 65 71 75 61 6c 69 74 79 20  ntains equality 
b120: 63 6f 6d 70 61 72 69 73 6f 6e 73 0a 63 6f 6e 6e  comparisons.conn
b130: 65 63 74 65 64 20 62 79 20 74 68 65 20 41 4e 44  ected by the AND
b140: 20 6f 70 65 72 61 74 6f 72 2e 3c 2f 70 3e 0a 0a   operator.</p>..
b150: 3c 70 3e 54 68 65 20 47 52 4f 55 50 20 42 59 20  <p>The GROUP BY 
b160: 63 6c 61 75 73 65 73 20 63 61 75 73 65 73 20 6f  clauses causes o
b170: 6e 65 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20  ne or more rows 
b180: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 74 6f  of the result to
b190: 0a 62 65 20 63 6f 6d 62 69 6e 65 64 20 69 6e 74  .be combined int
b1a0: 6f 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f  o a single row o
b1b0: 66 20 6f 75 74 70 75 74 2e 20 20 54 68 69 73 20  f output.  This 
b1c0: 69 73 20 65 73 70 65 63 69 61 6c 6c 79 20 75 73  is especially us
b1d0: 65 66 75 6c 0a 77 68 65 6e 20 74 68 65 20 72 65  eful.when the re
b1e0: 73 75 6c 74 20 63 6f 6e 74 61 69 6e 73 20 61 67  sult contains ag
b1f0: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
b200: 73 2e 20 20 54 68 65 20 65 78 70 72 65 73 73 69  s.  The expressi
b210: 6f 6e 73 20 69 6e 0a 74 68 65 20 47 52 4f 55 50  ons in.the GROUP
b220: 20 42 59 20 63 6c 61 75 73 65 20 64 6f 20 3c 65   BY clause do <e
b230: 6d 3e 6e 6f 74 3c 2f 65 6d 3e 20 68 61 76 65 20  m>not</em> have 
b240: 74 6f 20 62 65 20 65 78 70 72 65 73 73 69 6f 6e  to be expression
b250: 73 20 74 68 61 74 0a 61 70 70 65 61 72 20 69 6e  s that.appear in
b260: 20 74 68 65 20 72 65 73 75 6c 74 2e 20 20 54 68   the result.  Th
b270: 65 20 48 41 56 49 4e 47 20 63 6c 61 75 73 65 20  e HAVING clause 
b280: 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 57 48  is similar to WH
b290: 45 52 45 20 65 78 63 65 70 74 0a 74 68 61 74 20  ERE except.that 
b2a0: 48 41 56 49 4e 47 20 61 70 70 6c 69 65 73 20 61  HAVING applies a
b2b0: 66 74 65 72 20 67 72 6f 75 70 69 6e 67 20 68 61  fter grouping ha
b2c0: 73 20 6f 63 63 75 72 72 65 64 2e 20 20 54 68 65  s occurred.  The
b2d0: 20 48 41 56 49 4e 47 20 65 78 70 72 65 73 73 69   HAVING expressi
b2e0: 6f 6e 0a 6d 61 79 20 72 65 66 65 72 20 74 6f 20  on.may refer to 
b2f0: 76 61 6c 75 65 73 2c 20 65 76 65 6e 20 61 67 67  values, even agg
b300: 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73  regate functions
b310: 2c 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 69  , that are not i
b320: 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 3c 2f 70  n the result.</p
b330: 3e 0a 0a 3c 70 3e 54 68 65 20 4f 52 44 45 52 20  >..<p>The ORDER 
b340: 42 59 20 63 6c 61 75 73 65 20 63 61 75 73 65 73  BY clause causes
b350: 20 74 68 65 20 6f 75 74 70 75 74 20 72 6f 77 73   the output rows
b360: 20 74 6f 20 62 65 20 73 6f 72 74 65 64 2e 20 20   to be sorted.  
b370: 0a 54 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f  .The argument to
b380: 20 4f 52 44 45 52 20 42 59 20 69 73 20 61 20 6c   ORDER BY is a l
b390: 69 73 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f  ist of expressio
b3a0: 6e 73 20 74 68 61 74 20 61 72 65 20 75 73 65 64  ns that are used
b3b0: 20 61 73 20 74 68 65 0a 6b 65 79 20 66 6f 72 20   as the.key for 
b3c0: 74 68 65 20 73 6f 72 74 2e 20 20 54 68 65 20 65  the sort.  The e
b3d0: 78 70 72 65 73 73 69 6f 6e 73 20 64 6f 20 6e 6f  xpressions do no
b3e0: 74 20 68 61 76 65 20 74 6f 20 62 65 20 70 61 72  t have to be par
b3f0: 74 20 6f 66 20 74 68 65 0a 72 65 73 75 6c 74 20  t of the.result 
b400: 66 6f 72 20 61 20 73 69 6d 70 6c 65 20 53 45 4c  for a simple SEL
b410: 45 43 54 2c 20 62 75 74 20 69 6e 20 61 20 63 6f  ECT, but in a co
b420: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 20 65 61  mpound SELECT ea
b430: 63 68 20 73 6f 72 74 0a 65 78 70 72 65 73 73 69  ch sort.expressi
b440: 6f 6e 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20  on must exactly 
b450: 6d 61 74 63 68 20 6f 6e 65 20 6f 66 20 74 68 65  match one of the
b460: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e   result columns.
b470: 20 20 45 61 63 68 0a 73 6f 72 74 20 65 78 70 72    Each.sort expr
b480: 65 73 73 69 6f 6e 20 6d 61 79 20 62 65 20 6f 70  ession may be op
b490: 74 69 6f 6e 61 6c 6c 79 20 66 6f 6c 6c 6f 77 65  tionally followe
b4a0: 64 20 62 79 20 41 53 43 20 6f 72 20 44 45 53 43  d by ASC or DESC
b4b0: 20 74 6f 20 73 70 65 63 69 66 79 0a 74 68 65 20   to specify.the 
b4c0: 73 6f 72 74 20 6f 72 64 65 72 2e 3c 2f 70 3e 0a  sort order.</p>.
b4d0: 0a 3c 70 3e 54 68 65 20 4c 49 4d 49 54 20 63 6c  .<p>The LIMIT cl
b4e0: 61 75 73 65 20 70 6c 61 63 65 73 20 61 6e 20 75  ause places an u
b4f0: 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68  pper bound on th
b500: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73  e number of rows
b510: 0a 72 65 74 75 72 6e 65 64 20 69 6e 20 74 68 65  .returned in the
b520: 20 72 65 73 75 6c 74 2e 20 20 41 20 4c 49 4d 49   result.  A LIMI
b530: 54 20 6f 66 20 30 20 69 6e 64 69 63 61 74 65 73  T of 0 indicates
b540: 20 6e 6f 20 75 70 70 65 72 20 62 6f 75 6e 64 2e   no upper bound.
b550: 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 4f 46  .The optional OF
b560: 46 53 45 54 20 66 6f 6c 6c 6f 77 69 6e 67 20 4c  FSET following L
b570: 49 4d 49 54 20 73 70 65 63 69 66 69 65 73 20 68  IMIT specifies h
b580: 6f 77 20 6d 61 6e 79 0a 72 6f 77 73 20 74 6f 20  ow many.rows to 
b590: 73 6b 69 70 20 61 74 20 74 68 65 20 62 65 67 69  skip at the begi
b5a0: 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 72 65 73  nning of the res
b5b0: 75 6c 74 20 73 65 74 2e 3c 2f 70 3e 0a 0a 3c 70  ult set.</p>..<p
b5c0: 3e 41 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45  >A compound SELE
b5d0: 43 54 20 69 73 20 66 6f 72 6d 65 64 20 66 72 6f  CT is formed fro
b5e0: 6d 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 73 69  m two or more si
b5f0: 6d 70 6c 65 20 53 45 4c 45 43 54 73 20 63 6f 6e  mple SELECTs con
b600: 6e 65 63 74 65 64 0a 62 79 20 6f 6e 65 20 6f 66  nected.by one of
b610: 20 74 68 65 20 6f 70 65 72 61 74 6f 72 73 20 55   the operators U
b620: 4e 49 4f 4e 2c 20 55 4e 49 4f 4e 20 41 4c 4c 2c  NION, UNION ALL,
b630: 20 49 4e 54 45 52 53 45 43 54 2c 20 6f 72 20 45   INTERSECT, or E
b640: 58 43 45 50 54 2e 20 20 49 6e 0a 61 20 63 6f 6d  XCEPT.  In.a com
b650: 70 6f 75 6e 64 20 53 45 4c 45 43 54 2c 20 61 6c  pound SELECT, al
b660: 6c 20 74 68 65 20 63 6f 6e 73 74 69 74 75 65 6e  l the constituen
b670: 74 20 53 45 4c 45 43 54 73 20 6d 75 73 74 20 73  t SELECTs must s
b680: 70 65 63 69 66 79 20 74 68 65 0a 73 61 6d 65 20  pecify the.same 
b690: 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74  number of result
b6a0: 20 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 65 72 65   columns.  There
b6b0: 20 6d 61 79 20 62 65 20 6f 6e 6c 79 20 61 20 73   may be only a s
b6c0: 69 6e 67 6c 65 20 4f 52 44 45 52 20 42 59 0a 63  ingle ORDER BY.c
b6d0: 6c 61 75 73 65 20 61 74 20 74 68 65 20 65 6e 64  lause at the end
b6e0: 20 6f 66 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64   of the compound
b6f0: 20 53 45 4c 45 43 54 2e 20 20 54 68 65 20 55 4e   SELECT.  The UN
b700: 49 4f 4e 20 61 6e 64 20 55 4e 49 4f 4e 20 41 4c  ION and UNION AL
b710: 4c 0a 6f 70 65 72 61 74 6f 72 73 20 63 6f 6d 62  L.operators comb
b720: 69 6e 65 20 74 68 65 20 72 65 73 75 6c 74 73 20  ine the results 
b730: 6f 66 20 74 68 65 20 53 45 4c 45 43 54 73 20 74  of the SELECTs t
b740: 6f 20 74 68 65 20 72 69 67 68 74 20 61 6e 64 20  o the right and 
b750: 6c 65 66 74 20 69 6e 74 6f 0a 61 20 73 69 6e 67  left into.a sing
b760: 6c 65 20 62 69 67 20 74 61 62 6c 65 2e 20 20 54  le big table.  T
b770: 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 69 73  he difference is
b780: 20 74 68 61 74 20 69 6e 20 55 4e 49 4f 4e 20 61   that in UNION a
b790: 6c 6c 20 72 65 73 75 6c 74 20 72 6f 77 73 0a 61  ll result rows.a
b7a0: 72 65 20 64 69 73 74 69 6e 63 74 20 77 68 65 72  re distinct wher
b7b0: 65 20 69 6e 20 55 4e 49 4f 4e 20 41 4c 4c 20 74  e in UNION ALL t
b7c0: 68 65 72 65 20 6d 61 79 20 62 65 20 64 75 70 6c  here may be dupl
b7d0: 69 63 61 74 65 73 2e 0a 54 68 65 20 49 4e 54 45  icates..The INTE
b7e0: 52 53 45 43 54 20 6f 70 65 72 61 74 6f 72 20 74  RSECT operator t
b7f0: 61 6b 65 73 20 74 68 65 20 69 6e 74 65 72 73 65  akes the interse
b800: 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 72 65 73  ction of the res
b810: 75 6c 74 73 20 6f 66 20 74 68 65 0a 6c 65 66 74  ults of the.left
b820: 20 61 6e 64 20 72 69 67 68 74 20 53 45 4c 45 43   and right SELEC
b830: 54 73 2e 20 20 45 58 43 45 50 54 20 74 61 6b 65  Ts.  EXCEPT take
b840: 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20  s the result of 
b850: 6c 65 66 74 20 53 45 4c 45 43 54 20 61 66 74 65  left SELECT afte
b860: 72 0a 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 72  r.removing the r
b870: 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 72 69  esults of the ri
b880: 67 68 74 20 53 45 4c 45 43 54 2e 20 20 57 68 65  ght SELECT.  Whe
b890: 6e 20 74 68 72 65 65 20 61 72 65 20 6d 6f 72 65  n three are more
b8a0: 20 53 45 4c 45 43 54 73 0a 61 72 65 20 63 6f 6e   SELECTs.are con
b8b0: 6e 65 63 74 65 64 20 69 6e 74 6f 20 61 20 63 6f  nected into a co
b8c0: 6d 70 6f 75 6e 64 2c 20 74 68 65 79 20 67 72 6f  mpound, they gro
b8d0: 75 70 20 66 72 6f 6d 20 6c 65 66 74 20 74 6f 20  up from left to 
b8e0: 72 69 67 68 74 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65  right.</p>.}..Se
b8f0: 63 74 69 6f 6e 20 55 50 44 41 54 45 20 75 70 64  ction UPDATE upd
b900: 61 74 65 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c  ate..Syntax {sql
b910: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 55 50  -statement} {.UP
b920: 44 41 54 45 20 5b 20 4f 52 20 3c 63 6f 6e 66 6c  DATE [ OR <confl
b930: 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 20 5d  ict-algorithm> ]
b940: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 0a 53 45   <table-name>.SE
b950: 54 20 3c 61 73 73 69 67 6e 6d 65 6e 74 3e 20 5b  T <assignment> [
b960: 2c 20 3c 61 73 73 69 67 6e 6d 65 6e 74 3e 5d 20  , <assignment>] 
b970: 0a 5b 57 48 45 52 45 20 3c 65 78 70 72 3e 5d 0a  .[WHERE <expr>].
b980: 7d 20 7b 61 73 73 69 67 6e 6d 65 6e 74 7d 20 7b  } {assignment} {
b990: 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 3d  .<column-name> =
b9a0: 20 3c 65 78 70 72 3e 0a 7d 0a 0a 70 75 74 73 20   <expr>.}..puts 
b9b0: 7b 0a 3c 70 3e 54 68 65 20 55 50 44 41 54 45 20  {.<p>The UPDATE 
b9c0: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 75 73 65  statement is use
b9d0: 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20  d to change the 
b9e0: 76 61 6c 75 65 20 6f 66 20 63 6f 6c 75 6d 6e 73  value of columns
b9f0: 20 69 6e 20 0a 73 65 6c 65 63 74 65 64 20 72 6f   in .selected ro
ba00: 77 73 20 6f 66 20 61 20 74 61 62 6c 65 2e 20 20  ws of a table.  
ba10: 45 61 63 68 20 61 73 73 69 67 6e 6d 65 6e 74 20  Each assignment 
ba20: 69 6e 20 61 6e 20 55 50 44 41 54 45 20 73 70 65  in an UPDATE spe
ba30: 63 69 66 69 65 73 0a 61 20 63 6f 6c 75 6d 6e 20  cifies.a column 
ba40: 6e 61 6d 65 20 74 6f 20 74 68 65 20 6c 65 66 74  name to the left
ba50: 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73 20 73   of the equals s
ba60: 69 67 6e 20 61 6e 64 20 61 6e 20 61 72 62 69 74  ign and an arbit
ba70: 72 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e 0a  rary expression.
ba80: 74 6f 20 74 68 65 20 72 69 67 68 74 2e 20 20 54  to the right.  T
ba90: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 6d  he expressions m
baa0: 61 79 20 75 73 65 20 74 68 65 20 76 61 6c 75 65  ay use the value
bab0: 73 20 6f 66 20 6f 74 68 65 72 20 63 6f 6c 75 6d  s of other colum
bac0: 6e 73 2e 0a 41 6c 6c 20 65 78 70 72 65 73 73 69  ns..All expressi
bad0: 6f 6e 73 20 61 72 65 20 65 76 61 6c 75 61 74 65  ons are evaluate
bae0: 64 20 62 65 66 6f 72 65 20 61 6e 79 20 61 73 73  d before any ass
baf0: 69 67 6e 6d 65 6e 74 73 20 61 72 65 20 6d 61 64  ignments are mad
bb00: 65 2e 0a 41 20 57 48 45 52 45 20 63 6c 61 75 73  e..A WHERE claus
bb10: 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  e can be used to
bb20: 20 72 65 73 74 72 69 63 74 20 77 68 69 63 68 20   restrict which 
bb30: 72 6f 77 73 20 61 72 65 20 75 70 64 61 74 65 64  rows are updated
bb40: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70  .</p>..<p>The op
bb50: 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d  tional conflict-
bb60: 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20 74 68  clause allows th
bb70: 65 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20  e specification 
bb80: 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76  of an alternativ
bb90: 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e  e.constraint con
bba0: 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e  flict resolution
bbb0: 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 75 73   algorithm to us
bbc0: 65 20 64 75 72 69 6e 67 20 74 68 69 73 20 6f 6e  e during this on
bbd0: 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20 74  e command..See t
bbe0: 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c 65  he section title
bbf0: 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66  d.<a href="#conf
bc00: 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43  lict">ON CONFLIC
bc10: 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74 69  T</a> for additi
bc20: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
bc30: 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e  .</p>.}..Section
bc40: 20 56 41 43 55 55 4d 20 76 61 63 75 75 6d 0a 0a   VACUUM vacuum..
bc50: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
bc60: 65 6d 65 6e 74 7d 20 7b 0a 56 41 43 55 55 4d 20  ement} {.VACUUM 
bc70: 5b 3c 69 6e 64 65 78 2d 6f 72 2d 74 61 62 6c 65  [<index-or-table
bc80: 2d 6e 61 6d 65 3e 5d 0a 7d 0a 0a 70 75 74 73 20  -name>].}..puts 
bc90: 7b 0a 3c 70 3e 54 68 65 20 56 41 43 55 55 4d 20  {.<p>The VACUUM 
bca0: 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e 20 53 51  command is an SQ
bcb0: 4c 69 74 65 20 65 78 74 65 6e 73 69 6f 6e 20 6d  Lite extension m
bcc0: 6f 64 65 6c 6c 65 64 20 61 66 74 65 72 20 61 20  odelled after a 
bcd0: 73 69 6d 69 6c 61 72 0a 63 6f 6d 6d 61 6e 64 20  similar.command 
bce0: 66 6f 75 6e 64 20 69 6e 20 50 6f 73 74 67 72 65  found in Postgre
bcf0: 53 51 4c 2e 20 20 49 66 20 56 41 43 55 55 4d 20  SQL.  If VACUUM 
bd00: 69 73 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20  is invoked with 
bd10: 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 0a 74 61  the name of a.ta
bd20: 62 6c 65 20 6f 72 20 69 6e 64 65 78 20 74 68 65  ble or index the
bd30: 6e 20 69 74 20 69 73 20 73 75 70 70 6f 73 65 20  n it is suppose 
bd40: 74 6f 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20  to clean up the 
bd50: 6e 61 6d 65 64 20 74 61 62 6c 65 20 6f 72 20 69  named table or i
bd60: 6e 64 65 78 2e 0a 49 6e 20 76 65 72 73 69 6f 6e  ndex..In version
bd70: 20 31 2e 30 20 6f 66 20 53 51 4c 69 74 65 2c 20   1.0 of SQLite, 
bd80: 74 68 65 20 56 41 43 55 55 4d 20 63 6f 6d 6d 61  the VACUUM comma
bd90: 6e 64 20 77 6f 75 6c 64 20 69 6e 76 6f 6b 65 20  nd would invoke 
bda0: 0a 3c 62 3e 67 64 62 6d 5f 72 65 6f 72 67 61 6e  .<b>gdbm_reorgan
bdb0: 69 7a 65 28 29 3c 2f 62 3e 20 74 6f 20 63 6c 65  ize()</b> to cle
bdc0: 61 6e 20 75 70 20 74 68 65 20 62 61 63 6b 65 6e  an up the backen
bdd0: 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  d database file.
bde0: 0a 42 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20  .Beginning with 
bdf0: 76 65 72 73 69 6f 6e 20 32 2e 30 20 6f 66 20 53  version 2.0 of S
be00: 51 4c 69 74 65 2c 20 47 44 42 4d 20 69 73 20 6e  QLite, GDBM is n
be10: 6f 20 6c 6f 6e 67 65 72 20 75 73 65 64 20 66 6f  o longer used fo
be20: 72 0a 74 68 65 20 64 61 74 61 62 61 73 65 20 62  r.the database b
be30: 61 63 6b 65 6e 64 20 61 6e 64 20 56 41 43 55 55  ackend and VACUU
be40: 4d 20 68 61 73 20 62 65 63 6f 6d 65 20 61 20 6e  M has become a n
be50: 6f 2d 6f 70 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 0a 70  o-op..</p>.}...p
be60: 75 74 73 20 7b 0a 3c 70 3e 3c 68 72 20 2f 3e 3c  uts {.<p><hr /><
be70: 2f 70 3e 0a 3c 70 3e 3c 61 20 68 72 65 66 3d 22  /p>.<p><a href="
be80: 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 3c 69 6d 67  index.html"><img
be90: 20 73 72 63 3d 22 2f 67 6f 62 61 63 6b 2e 6a 70   src="/goback.jp
bea0: 67 22 20 62 6f 72 64 65 72 3d 30 20 2f 3e 0a 42  g" border=0 />.B
beb0: 61 63 6b 20 74 6f 20 74 68 65 20 53 51 4c 69 74  ack to the SQLit
bec0: 65 20 48 6f 6d 65 20 50 61 67 65 3c 2f 61 3e 0a  e Home Page</a>.
bed0: 3c 2f 70 3e 0a 0a 3c 2f 62 6f 64 79 3e 3c 2f 68  </p>..</body></h
bee0: 74 6d 6c 3e 7d 0a                                tml>}.