System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact eb725f0bc37ab33e805db4ecc1ee493ad5b96f11:


0000: 3c 21 44 4f 43 54 59 50 45 20 48 54 4d 4c 20 50  <!DOCTYPE HTML P
0010: 55 42 4c 49 43 20 22 2d 2f 2f 57 33 43 2f 2f 44  UBLIC "-//W3C//D
0020: 54 44 20 48 54 4d 4c 20 34 2e 30 31 2f 2f 45 4e  TD HTML 4.01//EN
0030: 22 20 22 68 74 74 70 3a 2f 2f 77 77 77 2e 77 33  " "http://www.w3
0040: 2e 6f 72 67 2f 54 52 2f 68 74 6d 6c 34 2f 73 74  .org/TR/html4/st
0050: 72 69 63 74 2e 64 74 64 22 3e 0a 3c 68 74 6d 6c  rict.dtd">.<html
0060: 3e 3c 68 65 61 64 3e 0a 3c 6d 65 74 61 20 6e 61  ><head>.<meta na
0070: 6d 65 3d 22 76 69 65 77 70 6f 72 74 22 20 63 6f  me="viewport" co
0080: 6e 74 65 6e 74 3d 22 77 69 64 74 68 3d 64 65 76  ntent="width=dev
0090: 69 63 65 2d 77 69 64 74 68 2c 20 69 6e 69 74 69  ice-width, initi
00a0: 61 6c 2d 73 63 61 6c 65 3d 31 2e 30 22 3e 0a 3c  al-scale=1.0">.<
00b0: 6d 65 74 61 20 68 74 74 70 2d 65 71 75 69 76 3d  meta http-equiv=
00c0: 22 63 6f 6e 74 65 6e 74 2d 74 79 70 65 22 20 63  "content-type" c
00d0: 6f 6e 74 65 6e 74 3d 22 74 65 78 74 2f 68 74 6d  ontent="text/htm
00e0: 6c 3b 20 63 68 61 72 73 65 74 3d 55 54 46 2d 38  l; charset=UTF-8
00f0: 22 3e 0a 3c 6c 69 6e 6b 20 68 72 65 66 3d 22 73  ">.<link href="s
0100: 71 6c 69 74 65 2e 63 73 73 22 20 72 65 6c 3d 22  qlite.css" rel="
0110: 73 74 79 6c 65 73 68 65 65 74 22 3e 0a 3c 74 69  stylesheet">.<ti
0120: 74 6c 65 3e 53 51 4c 69 74 65 20 51 75 65 72 79  tle>SQLite Query
0130: 20 4c 61 6e 67 75 61 67 65 3a 20 41 4e 41 4c 59   Language: ANALY
0140: 5a 45 3c 2f 74 69 74 6c 65 3e 0a 3c 21 2d 2d 20  ZE</title>.<!-- 
0150: 70 61 74 68 3d 20 2d 2d 3e 0a 3c 2f 68 65 61 64  path= -->.</head
0160: 3e 0a 3c 62 6f 64 79 3e 0a 3c 64 69 76 20 63 6c  >.<body>.<div cl
0170: 61 73 73 3d 6e 6f 73 65 61 72 63 68 3e 0a 3c 61  ass=nosearch>.<a
0180: 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d   href="index.htm
0190: 6c 22 3e 0a 3c 69 6d 67 20 63 6c 61 73 73 3d 22  l">.<img class="
01a0: 6c 6f 67 6f 22 20 73 72 63 3d 22 69 6d 61 67 65  logo" src="image
01b0: 73 2f 73 71 6c 69 74 65 33 37 30 5f 62 61 6e 6e  s/sqlite370_bann
01c0: 65 72 2e 67 69 66 22 20 61 6c 74 3d 22 53 51 4c  er.gif" alt="SQL
01d0: 69 74 65 22 20 62 6f 72 64 65 72 3d 22 30 22 3e  ite" border="0">
01e0: 0a 3c 2f 61 3e 0a 3c 64 69 76 3e 3c 21 2d 2d 20  .</a>.<div><!-- 
01f0: 49 45 20 68 61 63 6b 20 74 6f 20 70 72 65 76 65  IE hack to preve
0200: 6e 74 20 64 69 73 61 70 70 65 61 72 69 6e 67 20  nt disappearing 
0210: 6c 6f 67 6f 20 2d 2d 3e 3c 2f 64 69 76 3e 0a 3c  logo --></div>.<
0220: 64 69 76 20 63 6c 61 73 73 3d 22 74 61 67 6c 69  div class="tagli
0230: 6e 65 20 64 65 73 6b 74 6f 70 6f 6e 6c 79 22 3e  ne desktoponly">
0240: 0a 53 6d 61 6c 6c 2e 20 46 61 73 74 2e 20 52 65  .Small. Fast. Re
0250: 6c 69 61 62 6c 65 2e 3c 62 72 3e 43 68 6f 6f 73  liable.<br>Choos
0260: 65 20 61 6e 79 20 74 68 72 65 65 2e 0a 3c 2f 64  e any three..</d
0270: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  iv>.<div class="
0280: 6d 65 6e 75 20 6d 61 69 6e 6d 65 6e 75 22 3e 0a  menu mainmenu">.
0290: 3c 75 6c 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66  <ul>.<li><a href
02a0: 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 48 6f  ="index.html">Ho
02b0: 6d 65 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73  me</a>.<li class
02c0: 3d 27 6d 6f 62 69 6c 65 6f 6e 6c 79 27 3e 3c 61  ='mobileonly'><a
02d0: 20 68 72 65 66 3d 22 6a 61 76 61 73 63 72 69 70   href="javascrip
02e0: 74 3a 76 6f 69 64 28 30 29 22 20 6f 6e 63 6c 69  t:void(0)" oncli
02f0: 63 6b 3d 27 74 6f 67 67 6c 65 5f 64 69 76 28 22  ck='toggle_div("
0300: 73 75 62 6d 65 6e 75 22 29 27 3e 4d 65 6e 75 3c  submenu")'>Menu<
0310: 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 77  /a>.<li class='w
0320: 69 64 65 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66  ideonly'><a href
0330: 3d 27 61 62 6f 75 74 2e 68 74 6d 6c 27 3e 41 62  ='about.html'>Ab
0340: 6f 75 74 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73  out</a>.<li clas
0350: 73 3d 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e  s='desktoponly'>
0360: 3c 61 20 68 72 65 66 3d 22 64 6f 63 73 2e 68 74  <a href="docs.ht
0370: 6d 6c 22 3e 44 6f 63 75 6d 65 6e 74 61 74 69 6f  ml">Documentatio
0380: 6e 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d  n</a>.<li class=
0390: 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e 3c 61  'desktoponly'><a
03a0: 20 68 72 65 66 3d 22 64 6f 77 6e 6c 6f 61 64 2e   href="download.
03b0: 68 74 6d 6c 22 3e 44 6f 77 6e 6c 6f 61 64 3c 2f  html">Download</
03c0: 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 77 69  a>.<li class='wi
03d0: 64 65 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d  deonly'><a href=
03e0: 27 63 6f 70 79 72 69 67 68 74 2e 68 74 6d 6c 27  'copyright.html'
03f0: 3e 4c 69 63 65 6e 73 65 3c 2f 61 3e 0a 3c 6c 69  >License</a>.<li
0400: 20 63 6c 61 73 73 3d 27 64 65 73 6b 74 6f 70 6f   class='desktopo
0410: 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d 22 73 75  nly'><a href="su
0420: 70 70 6f 72 74 2e 68 74 6d 6c 22 3e 53 75 70 70  pport.html">Supp
0430: 6f 72 74 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73  ort</a>.<li clas
0440: 73 3d 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e  s='desktoponly'>
0450: 3c 61 20 68 72 65 66 3d 22 70 72 6f 73 75 70 70  <a href="prosupp
0460: 6f 72 74 2e 68 74 6d 6c 22 3e 50 75 72 63 68 61  ort.html">Purcha
0470: 73 65 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73  se</a>.<li class
0480: 3d 27 73 65 61 72 63 68 27 20 69 64 3d 27 73 65  ='search' id='se
0490: 61 72 63 68 5f 6d 65 6e 75 62 75 74 74 6f 6e 27  arch_menubutton'
04a0: 3e 0a 3c 61 20 68 72 65 66 3d 22 6a 61 76 61 73  >.<a href="javas
04b0: 63 72 69 70 74 3a 76 6f 69 64 28 30 29 22 20 6f  cript:void(0)" o
04c0: 6e 63 6c 69 63 6b 3d 27 74 6f 67 67 6c 65 5f 73  nclick='toggle_s
04d0: 65 61 72 63 68 28 29 27 3e 53 65 61 72 63 68 3c  earch()'>Search<
04e0: 2f 61 3e 0a 3c 2f 75 6c 3e 0a 3c 2f 64 69 76 3e  /a>.</ul>.</div>
04f0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6d 65 6e  .<div class="men
0500: 75 20 73 75 62 6d 65 6e 75 22 20 69 64 3d 22 73  u submenu" id="s
0510: 75 62 6d 65 6e 75 22 3e 0a 3c 75 6c 3e 0a 3c 6c  ubmenu">.<ul>.<l
0520: 69 3e 3c 61 20 68 72 65 66 3d 27 61 62 6f 75 74  i><a href='about
0530: 2e 68 74 6d 6c 27 3e 41 62 6f 75 74 3c 2f 61 3e  .html'>About</a>
0540: 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 27 64 6f  .<li><a href='do
0550: 63 73 2e 68 74 6d 6c 27 3e 44 6f 63 75 6d 65 6e  cs.html'>Documen
0560: 74 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 6c 69 3e 3c  tation</a>.<li><
0570: 61 20 68 72 65 66 3d 27 64 6f 77 6e 6c 6f 61 64  a href='download
0580: 2e 68 74 6d 6c 27 3e 44 6f 77 6e 6c 6f 61 64 3c  .html'>Download<
0590: 2f 61 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d  /a>.<li><a href=
05a0: 27 73 75 70 70 6f 72 74 2e 68 74 6d 6c 27 3e 53  'support.html'>S
05b0: 75 70 70 6f 72 74 3c 2f 61 3e 0a 3c 6c 69 3e 3c  upport</a>.<li><
05c0: 61 20 68 72 65 66 3d 27 70 72 6f 73 75 70 70 6f  a href='prosuppo
05d0: 72 74 2e 68 74 6d 6c 27 3e 50 75 72 63 68 61 73  rt.html'>Purchas
05e0: 65 3c 2f 61 3e 0a 3c 2f 75 6c 3e 0a 3c 2f 64 69  e</a>.</ul>.</di
05f0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 73  v>.<div class="s
0600: 65 61 72 63 68 6d 65 6e 75 22 20 69 64 3d 22 73  earchmenu" id="s
0610: 65 61 72 63 68 6d 65 6e 75 22 3e 0a 3c 66 6f 72  earchmenu">.<for
0620: 6d 20 6d 65 74 68 6f 64 3d 22 47 45 54 22 20 61  m method="GET" a
0630: 63 74 69 6f 6e 3d 22 73 65 61 72 63 68 22 3e 0a  ction="search">.
0640: 3c 73 65 6c 65 63 74 20 6e 61 6d 65 3d 22 73 22  <select name="s"
0650: 20 69 64 3d 22 73 65 61 72 63 68 74 79 70 65 22   id="searchtype"
0660: 3e 0a 3c 6f 70 74 69 6f 6e 20 76 61 6c 75 65 3d  >.<option value=
0670: 22 64 22 3e 53 65 61 72 63 68 20 44 6f 63 75 6d  "d">Search Docum
0680: 65 6e 74 61 74 69 6f 6e 3c 2f 6f 70 74 69 6f 6e  entation</option
0690: 3e 0a 3c 6f 70 74 69 6f 6e 20 76 61 6c 75 65 3d  >.<option value=
06a0: 22 63 22 3e 53 65 61 72 63 68 20 43 68 61 6e 67  "c">Search Chang
06b0: 65 6c 6f 67 3c 2f 6f 70 74 69 6f 6e 3e 0a 3c 2f  elog</option>.</
06c0: 73 65 6c 65 63 74 3e 0a 3c 69 6e 70 75 74 20 74  select>.<input t
06d0: 79 70 65 3d 22 74 65 78 74 22 20 6e 61 6d 65 3d  ype="text" name=
06e0: 22 71 22 20 69 64 3d 22 73 65 61 72 63 68 62 6f  "q" id="searchbo
06f0: 78 22 20 76 61 6c 75 65 3d 22 22 3e 0a 3c 69 6e  x" value="">.<in
0700: 70 75 74 20 74 79 70 65 3d 22 73 75 62 6d 69 74  put type="submit
0710: 22 20 76 61 6c 75 65 3d 22 47 6f 22 3e 0a 3c 2f  " value="Go">.</
0720: 66 6f 72 6d 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64  form>.</div>.</d
0730: 69 76 3e 0a 3c 73 63 72 69 70 74 3e 0a 66 75 6e  iv>.<script>.fun
0740: 63 74 69 6f 6e 20 74 6f 67 67 6c 65 5f 64 69 76  ction toggle_div
0750: 28 6e 6d 29 20 7b 0a 76 61 72 20 77 20 3d 20 64  (nm) {.var w = d
0760: 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d 65  ocument.getEleme
0770: 6e 74 42 79 49 64 28 6e 6d 29 3b 0a 69 66 28 20  ntById(nm);.if( 
0780: 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79 3d  w.style.display=
0790: 3d 22 62 6c 6f 63 6b 22 20 29 7b 0a 77 2e 73 74  ="block" ){.w.st
07a0: 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20 22 6e  yle.display = "n
07b0: 6f 6e 65 22 3b 0a 7d 65 6c 73 65 7b 0a 77 2e 73  one";.}else{.w.s
07c0: 74 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20 22  tyle.display = "
07d0: 62 6c 6f 63 6b 22 3b 0a 7d 0a 7d 0a 66 75 6e 63  block";.}.}.func
07e0: 74 69 6f 6e 20 74 6f 67 67 6c 65 5f 73 65 61 72  tion toggle_sear
07f0: 63 68 28 29 20 7b 0a 76 61 72 20 77 20 3d 20 64  ch() {.var w = d
0800: 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d 65  ocument.getEleme
0810: 6e 74 42 79 49 64 28 22 73 65 61 72 63 68 6d 65  ntById("searchme
0820: 6e 75 22 29 3b 0a 69 66 28 20 77 2e 73 74 79 6c  nu");.if( w.styl
0830: 65 2e 64 69 73 70 6c 61 79 3d 3d 22 62 6c 6f 63  e.display=="bloc
0840: 6b 22 20 29 7b 0a 77 2e 73 74 79 6c 65 2e 64 69  k" ){.w.style.di
0850: 73 70 6c 61 79 20 3d 20 22 6e 6f 6e 65 22 3b 0a  splay = "none";.
0860: 7d 20 65 6c 73 65 20 7b 0a 77 2e 73 74 79 6c 65  } else {.w.style
0870: 2e 64 69 73 70 6c 61 79 20 3d 20 22 62 6c 6f 63  .display = "bloc
0880: 6b 22 3b 0a 73 65 74 54 69 6d 65 6f 75 74 28 66  k";.setTimeout(f
0890: 75 6e 63 74 69 6f 6e 28 29 7b 0a 64 6f 63 75 6d  unction(){.docum
08a0: 65 6e 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79  ent.getElementBy
08b0: 49 64 28 22 73 65 61 72 63 68 62 6f 78 22 29 2e  Id("searchbox").
08c0: 66 6f 63 75 73 28 29 0a 7d 2c 20 33 30 29 3b 0a  focus().}, 30);.
08d0: 7d 0a 7d 0a 66 75 6e 63 74 69 6f 6e 20 64 69 76  }.}.function div
08e0: 5f 6f 66 66 28 6e 6d 29 7b 64 6f 63 75 6d 65 6e  _off(nm){documen
08f0: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
0900: 28 6e 6d 29 2e 73 74 79 6c 65 2e 64 69 73 70 6c  (nm).style.displ
0910: 61 79 3d 22 6e 6f 6e 65 22 3b 7d 0a 77 69 6e 64  ay="none";}.wind
0920: 6f 77 2e 6f 6e 62 65 66 6f 72 65 75 6e 6c 6f 61  ow.onbeforeunloa
0930: 64 20 3d 20 66 75 6e 63 74 69 6f 6e 28 65 29 7b  d = function(e){
0940: 64 69 76 5f 6f 66 66 28 22 73 75 62 6d 65 6e 75  div_off("submenu
0950: 22 29 3b 7d 0a 2f 2a 20 44 69 73 61 62 6c 65 20  ");}./* Disable 
0960: 74 68 65 20 53 65 61 72 63 68 20 66 65 61 74 75  the Search featu
0970: 72 65 20 69 66 20 77 65 20 61 72 65 20 6e 6f 74  re if we are not
0980: 20 6f 70 65 72 61 74 69 6e 67 20 66 72 6f 6d 20   operating from 
0990: 43 47 49 2c 20 73 69 6e 63 65 20 2a 2f 0a 2f 2a  CGI, since */./*
09a0: 20 53 65 61 72 63 68 20 69 73 20 61 63 63 6f 6d   Search is accom
09b0: 70 6c 69 73 68 65 64 20 75 73 69 6e 67 20 43 47  plished using CG
09c0: 49 20 61 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 77  I and will not w
09d0: 6f 72 6b 20 77 69 74 68 6f 75 74 20 69 74 2e 20  ork without it. 
09e0: 2a 2f 0a 69 66 28 20 21 6c 6f 63 61 74 69 6f 6e  */.if( !location
09f0: 2e 6f 72 69 67 69 6e 2e 6d 61 74 63 68 20 7c 7c  .origin.match ||
0a00: 20 21 6c 6f 63 61 74 69 6f 6e 2e 6f 72 69 67 69   !location.origi
0a10: 6e 2e 6d 61 74 63 68 28 2f 68 74 74 70 2f 29 20  n.match(/http/) 
0a20: 29 7b 0a 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45  ){.document.getE
0a30: 6c 65 6d 65 6e 74 42 79 49 64 28 22 73 65 61 72  lementById("sear
0a40: 63 68 5f 6d 65 6e 75 62 75 74 74 6f 6e 22 29 2e  ch_menubutton").
0a50: 73 74 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20  style.display = 
0a60: 22 6e 6f 6e 65 22 3b 0a 7d 0a 2f 2a 20 55 73 65  "none";.}./* Use
0a70: 64 20 62 79 20 74 68 65 20 48 69 64 65 2f 53 68  d by the Hide/Sh
0a80: 6f 77 20 62 75 74 74 6f 6e 20 62 65 73 69 64 65  ow button beside
0a90: 20 73 79 6e 74 61 78 20 64 69 61 67 72 61 6d 73   syntax diagrams
0aa0: 2c 20 74 6f 20 74 6f 67 67 6c 65 20 74 68 65 20  , to toggle the 
0ab0: 2a 2f 0a 66 75 6e 63 74 69 6f 6e 20 68 69 64 65  */.function hide
0ac0: 6f 72 73 68 6f 77 28 62 74 6e 2c 6f 62 6a 29 7b  orshow(btn,obj){
0ad0: 0a 76 61 72 20 78 20 3d 20 64 6f 63 75 6d 65 6e  .var x = documen
0ae0: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
0af0: 28 6f 62 6a 29 3b 0a 76 61 72 20 62 20 3d 20 64  (obj);.var b = d
0b00: 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d 65  ocument.getEleme
0b10: 6e 74 42 79 49 64 28 62 74 6e 29 3b 0a 69 66 28  ntById(btn);.if(
0b20: 20 78 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79   x.style.display
0b30: 21 3d 27 6e 6f 6e 65 27 20 29 7b 0a 78 2e 73 74  !='none' ){.x.st
0b40: 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20 27 6e  yle.display = 'n
0b50: 6f 6e 65 27 3b 0a 62 2e 69 6e 6e 65 72 48 54 4d  one';.b.innerHTM
0b60: 4c 3d 27 73 68 6f 77 27 3b 0a 7d 65 6c 73 65 7b  L='show';.}else{
0b70: 0a 78 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79  .x.style.display
0b80: 20 3d 20 27 27 3b 0a 62 2e 69 6e 6e 65 72 48 54   = '';.b.innerHT
0b90: 4d 4c 3d 27 68 69 64 65 27 3b 0a 7d 0a 72 65 74  ML='hide';.}.ret
0ba0: 75 72 6e 20 66 61 6c 73 65 3b 0a 7d 0a 3c 2f 73  urn false;.}.</s
0bb0: 63 72 69 70 74 3e 0a 3c 2f 64 69 76 3e 0a 3c 64  cript>.</div>.<d
0bc0: 69 76 20 63 6c 61 73 73 3d 6e 6f 73 65 61 72 63  iv class=nosearc
0bd0: 68 3e 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e  h><h1 align="cen
0be0: 74 65 72 22 3e 53 51 4c 20 41 73 20 55 6e 64 65  ter">SQL As Unde
0bf0: 72 73 74 6f 6f 64 20 42 79 20 53 51 4c 69 74 65  rstood By SQLite
0c00: 3c 2f 68 31 3e 3c 70 3e 3c 61 20 68 72 65 66 3d  </h1><p><a href=
0c10: 22 6c 61 6e 67 2e 68 74 6d 6c 22 3e 5b 54 6f 70  "lang.html">[Top
0c20: 5d 3c 2f 61 3e 3c 2f 70 3e 3c 68 32 3e 41 4e 41  ]</a></p><h2>ANA
0c30: 4c 59 5a 45 3c 2f 68 32 3e 3c 2f 64 69 76 3e 3c  LYZE</h2></div><
0c40: 70 3e 3c 62 3e 3c 61 20 68 72 65 66 3d 22 73 79  p><b><a href="sy
0c50: 6e 74 61 78 2f 61 6e 61 6c 79 7a 65 2d 73 74 6d  ntax/analyze-stm
0c60: 74 2e 68 74 6d 6c 22 3e 61 6e 61 6c 79 7a 65 2d  t.html">analyze-
0c70: 73 74 6d 74 3a 3c 2f 61 3e 3c 2f 62 3e 0a 3c 62  stmt:</a></b>.<b
0c80: 75 74 74 6f 6e 20 69 64 3d 27 78 31 31 32 35 27  utton id='x1125'
0c90: 20 6f 6e 63 6c 69 63 6b 3d 27 68 69 64 65 6f 72   onclick='hideor
0ca0: 73 68 6f 77 28 22 78 31 31 32 35 22 2c 22 78 31  show("x1125","x1
0cb0: 31 32 36 22 29 27 3e 68 69 64 65 3c 2f 62 75 74  126")'>hide</but
0cc0: 74 6f 6e 3e 3c 2f 70 3e 0a 20 3c 64 69 76 20 69  ton></p>. <div i
0cd0: 64 3d 27 78 31 31 32 36 27 20 63 6c 61 73 73 3d  d='x1126' class=
0ce0: 27 69 6d 67 63 6f 6e 74 61 69 6e 65 72 27 3e 0a  'imgcontainer'>.
0cf0: 20 3c 69 6d 67 20 61 6c 74 3d 22 73 79 6e 74 61   <img alt="synta
0d00: 78 20 64 69 61 67 72 61 6d 20 61 6e 61 6c 79 7a  x diagram analyz
0d10: 65 2d 73 74 6d 74 22 20 73 72 63 3d 22 69 6d 61  e-stmt" src="ima
0d20: 67 65 73 2f 73 79 6e 74 61 78 2f 61 6e 61 6c 79  ges/syntax/analy
0d30: 7a 65 2d 73 74 6d 74 2e 67 69 66 22 20 2f 3e 0a  ze-stmt.gif" />.
0d40: 3c 2f 64 69 76 3e 0a 0a 0a 3c 70 3e 20 54 68 65  </div>...<p> The
0d50: 20 41 4e 41 4c 59 5a 45 20 63 6f 6d 6d 61 6e 64   ANALYZE command
0d60: 20 67 61 74 68 65 72 73 20 73 74 61 74 69 73 74   gathers statist
0d70: 69 63 73 20 61 62 6f 75 74 20 74 61 62 6c 65 73  ics about tables
0d80: 20 61 6e 64 0a 69 6e 64 69 63 65 73 20 61 6e 64   and.indices and
0d90: 20 73 74 6f 72 65 73 20 74 68 65 20 63 6f 6c 6c   stores the coll
0da0: 65 63 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f  ected informatio
0db0: 6e 0a 69 6e 20 3c 61 20 68 72 65 66 3d 22 66 69  n.in <a href="fi
0dc0: 6c 65 66 6f 72 6d 61 74 32 2e 68 74 6d 6c 23 69  leformat2.html#i
0dd0: 6e 74 73 63 68 65 6d 61 22 3e 69 6e 74 65 72 6e  ntschema">intern
0de0: 61 6c 20 74 61 62 6c 65 73 3c 2f 61 3e 20 6f 66  al tables</a> of
0df0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 68   the database wh
0e00: 65 72 65 20 74 68 65 20 71 75 65 72 79 20 6f 70  ere the query op
0e10: 74 69 6d 69 7a 65 72 20 63 61 6e 0a 61 63 63 65  timizer can.acce
0e20: 73 73 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69  ss the informati
0e30: 6f 6e 20 61 6e 64 20 75 73 65 20 69 74 20 74 6f  on and use it to
0e40: 20 68 65 6c 70 20 6d 61 6b 65 20 62 65 74 74 65   help make bette
0e50: 72 20 71 75 65 72 79 20 70 6c 61 6e 6e 69 6e 67  r query planning
0e60: 20 63 68 6f 69 63 65 73 2e 0a 49 66 20 6e 6f 20   choices..If no 
0e70: 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 67 69  arguments are gi
0e80: 76 65 6e 2c 20 61 6c 6c 20 61 74 74 61 63 68 65  ven, all attache
0e90: 64 20 64 61 74 61 62 61 73 65 73 20 61 72 65 0a  d databases are.
0ea0: 61 6e 61 6c 79 7a 65 64 2e 20 20 49 66 20 61 20  analyzed.  If a 
0eb0: 73 63 68 65 6d 61 20 6e 61 6d 65 20 69 73 20 67  schema name is g
0ec0: 69 76 65 6e 20 61 73 20 74 68 65 20 61 72 67 75  iven as the argu
0ed0: 6d 65 6e 74 2c 20 74 68 65 6e 20 61 6c 6c 20 74  ment, then all t
0ee0: 61 62 6c 65 73 0a 61 6e 64 20 69 6e 64 69 63 65  ables.and indice
0ef0: 73 20 69 6e 20 74 68 61 74 20 6f 6e 65 20 64 61  s in that one da
0f00: 74 61 62 61 73 65 20 61 72 65 20 61 6e 61 6c 79  tabase are analy
0f10: 7a 65 64 2e 20 20 0a 49 66 20 74 68 65 20 61 72  zed.  .If the ar
0f20: 67 75 6d 65 6e 74 20 69 73 20 61 20 74 61 62 6c  gument is a tabl
0f30: 65 20 6e 61 6d 65 2c 20 74 68 65 6e 20 6f 6e 6c  e name, then onl
0f40: 79 20 74 68 61 74 20 74 61 62 6c 65 20 61 6e 64  y that table and
0f50: 20 74 68 65 0a 69 6e 64 69 63 65 73 20 61 73 73   the.indices ass
0f60: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 61  ociated with tha
0f70: 74 20 74 61 62 6c 65 20 61 72 65 20 61 6e 61 6c  t table are anal
0f80: 79 7a 65 64 2e 20 20 49 66 20 74 68 65 20 61 72  yzed.  If the ar
0f90: 67 75 6d 65 6e 74 0a 69 73 20 61 6e 20 69 6e 64  gument.is an ind
0fa0: 65 78 20 6e 61 6d 65 2c 20 74 68 65 6e 20 6f 6e  ex name, then on
0fb0: 6c 79 20 74 68 61 74 20 6f 6e 65 20 69 6e 64 65  ly that one inde
0fc0: 78 20 69 73 20 61 6e 61 6c 79 7a 65 64 2e 3c 2f  x is analyzed.</
0fd0: 70 3e 0a 0a 3c 70 3e 20 54 68 65 20 64 65 66 61  p>..<p> The defa
0fe0: 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ult implementati
0ff0: 6f 6e 20 73 74 6f 72 65 73 20 61 6c 6c 20 73 74  on stores all st
1000: 61 74 69 73 74 69 63 73 20 69 6e 20 61 20 73 69  atistics in a si
1010: 6e 67 6c 65 0a 74 61 62 6c 65 20 6e 61 6d 65 64  ngle.table named
1020: 20 22 3c 61 20 68 72 65 66 3d 22 66 69 6c 65 66   "<a href="filef
1030: 6f 72 6d 61 74 32 2e 68 74 6d 6c 23 73 74 61 74  ormat2.html#stat
1040: 31 74 61 62 22 3e 73 71 6c 69 74 65 5f 73 74 61  1tab">sqlite_sta
1050: 74 31 3c 2f 61 3e 22 2e 20 20 49 66 20 53 51 4c  t1</a>".  If SQL
1060: 69 74 65 20 69 73 20 63 6f 6d 70 69 6c 65 64 20  ite is compiled 
1070: 77 69 74 68 20 74 68 65 0a 3c 61 20 68 72 65 66  with the.<a href
1080: 3d 22 63 6f 6d 70 69 6c 65 2e 68 74 6d 6c 23 65  ="compile.html#e
1090: 6e 61 62 6c 65 5f 73 74 61 74 33 22 3e 53 51 4c  nable_stat3">SQL
10a0: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33  ITE_ENABLE_STAT3
10b0: 3c 2f 61 3e 20 6f 70 74 69 6f 6e 20 61 6e 64 20  </a> option and 
10c0: 77 69 74 68 6f 75 74 20 74 68 65 20 3c 61 20 68  without the <a h
10d0: 72 65 66 3d 22 63 6f 6d 70 69 6c 65 2e 68 74 6d  ref="compile.htm
10e0: 6c 23 65 6e 61 62 6c 65 5f 73 74 61 74 34 22 3e  l#enable_stat4">
10f0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54  SQLITE_ENABLE_ST
1100: 41 54 34 3c 2f 61 3e 0a 6f 70 74 69 6f 6e 2c 20  AT4</a>.option, 
1110: 74 68 65 6e 20 61 64 64 69 74 69 6f 6e 61 6c 20  then additional 
1120: 68 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20 69  histogram data i
1130: 73 0a 63 6f 6c 6c 65 63 74 65 64 20 61 6e 64 20  s.collected and 
1140: 73 74 6f 72 65 64 20 69 6e 20 3c 61 20 68 72 65  stored in <a hre
1150: 66 3d 22 66 69 6c 65 66 6f 72 6d 61 74 32 2e 68  f="fileformat2.h
1160: 74 6d 6c 23 73 74 61 74 33 74 61 62 22 3e 73 71  tml#stat3tab">sq
1170: 6c 69 74 65 5f 73 74 61 74 33 3c 2f 61 3e 2e 0a  lite_stat3</a>..
1180: 20 49 66 20 53 51 4c 69 74 65 20 69 73 20 63 6f   If SQLite is co
1190: 6d 70 69 6c 65 64 20 77 69 74 68 20 74 68 65 0a  mpiled with the.
11a0: 3c 61 20 68 72 65 66 3d 22 63 6f 6d 70 69 6c 65  <a href="compile
11b0: 2e 68 74 6d 6c 23 65 6e 61 62 6c 65 5f 73 74 61  .html#enable_sta
11c0: 74 34 22 3e 53 51 4c 49 54 45 5f 45 4e 41 42 4c  t4">SQLITE_ENABL
11d0: 45 5f 53 54 41 54 34 3c 2f 61 3e 20 6f 70 74 69  E_STAT4</a> opti
11e0: 6f 6e 2c 20 74 68 65 6e 20 61 64 64 69 74 69 6f  on, then additio
11f0: 6e 61 6c 20 68 69 73 74 6f 67 72 61 6d 20 64 61  nal histogram da
1200: 74 61 20 69 73 0a 63 6f 6c 6c 65 63 74 65 64 20  ta is.collected 
1210: 61 6e 64 20 73 74 6f 72 65 64 20 69 6e 20 3c 61  and stored in <a
1220: 20 68 72 65 66 3d 22 66 69 6c 65 66 6f 72 6d 61   href="fileforma
1230: 74 32 2e 68 74 6d 6c 23 73 74 61 74 34 74 61 62  t2.html#stat4tab
1240: 22 3e 73 71 6c 69 74 65 5f 73 74 61 74 34 3c 2f  ">sqlite_stat4</
1250: 61 3e 2e 0a 4f 6c 64 65 72 20 76 65 72 73 69 6f  a>..Older versio
1260: 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 77 6f 75  ns of SQLite wou
1270: 6c 64 20 6d 61 6b 65 20 75 73 65 20 6f 66 20 74  ld make use of t
1280: 68 65 20 3c 61 20 68 72 65 66 3d 22 66 69 6c 65  he <a href="file
1290: 66 6f 72 6d 61 74 32 2e 68 74 6d 6c 23 73 74 61  format2.html#sta
12a0: 74 32 74 61 62 22 3e 73 71 6c 69 74 65 5f 73 74  t2tab">sqlite_st
12b0: 61 74 32 3c 2f 61 3e 20 74 61 62 6c 65 0a 77 68  at2</a> table.wh
12c0: 65 6e 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68  en compiled with
12d0: 20 3c 61 20 68 72 65 66 3d 22 63 6f 6d 70 69 6c   <a href="compil
12e0: 65 2e 68 74 6d 6c 23 65 6e 61 62 6c 65 5f 73 74  e.html#enable_st
12f0: 61 74 32 22 3e 53 51 4c 49 54 45 5f 45 4e 41 42  at2">SQLITE_ENAB
1300: 4c 45 5f 53 54 41 54 32 3c 2f 61 3e 20 62 75 74  LE_STAT2</a> but
1310: 20 61 6c 6c 20 72 65 63 65 6e 74 20 76 65 72 73   all recent vers
1320: 69 6f 6e 73 20 6f 66 0a 53 51 4c 69 74 65 20 69  ions of.SQLite i
1330: 67 6e 6f 72 65 20 74 68 65 20 73 71 6c 69 74 65  gnore the sqlite
1340: 5f 73 74 61 74 32 20 74 61 62 6c 65 2e 0a 46 75  _stat2 table..Fu
1350: 74 75 72 65 20 65 6e 68 61 6e 63 65 6d 65 6e 74  ture enhancement
1360: 73 20 6d 61 79 20 63 72 65 61 74 65 0a 61 64 64  s may create.add
1370: 69 74 69 6f 6e 61 6c 20 3c 61 20 68 72 65 66 3d  itional <a href=
1380: 22 66 69 6c 65 66 6f 72 6d 61 74 32 2e 68 74 6d  "fileformat2.htm
1390: 6c 23 69 6e 74 73 63 68 65 6d 61 22 3e 69 6e 74  l#intschema">int
13a0: 65 72 6e 61 6c 20 74 61 62 6c 65 73 3c 2f 61 3e  ernal tables</a>
13b0: 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 6e   with the same n
13c0: 61 6d 65 20 70 61 74 74 65 72 6e 20 65 78 63 65  ame pattern exce
13d0: 70 74 20 77 69 74 68 0a 66 69 6e 61 6c 20 64 69  pt with.final di
13e0: 67 69 74 20 6c 61 72 67 65 72 20 74 68 61 6e 20  git larger than 
13f0: 22 34 22 2e 0a 41 6c 6c 20 6f 66 20 74 68 65 73  "4"..All of thes
1400: 65 20 74 61 62 6c 65 73 20 61 72 65 20 63 6f 6c  e tables are col
1410: 6c 65 63 74 69 76 65 6c 79 20 72 65 66 65 72 72  lectively referr
1420: 65 64 20 74 6f 20 61 73 20 22 73 74 61 74 69 73  ed to as "statis
1430: 74 69 63 73 20 74 61 62 6c 65 73 22 2e 0a 3c 2f  tics tables"..</
1440: 70 3e 0a 0a 3c 70 3e 20 54 68 65 20 63 6f 6e 74  p>..<p> The cont
1450: 65 6e 74 20 6f 66 20 74 68 65 20 73 74 61 74 69  ent of the stati
1460: 73 74 69 63 73 20 74 61 62 6c 65 73 20 63 61 6e  stics tables can
1470: 20 62 65 20 71 75 65 72 69 65 64 20 75 73 69 6e   be queried usin
1480: 67 20 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f  g <a href="lang_
1490: 73 65 6c 65 63 74 2e 68 74 6d 6c 22 3e 53 45 4c  select.html">SEL
14a0: 45 43 54 3c 2f 61 3e 0a 61 6e 64 20 63 61 6e 20  ECT</a>.and can 
14b0: 62 65 20 63 68 61 6e 67 65 64 20 75 73 69 6e 67  be changed using
14c0: 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 6c 61   the <a href="la
14d0: 6e 67 5f 64 65 6c 65 74 65 2e 68 74 6d 6c 22 3e  ng_delete.html">
14e0: 44 45 4c 45 54 45 3c 2f 61 3e 2c 20 3c 61 20 68  DELETE</a>, <a h
14f0: 72 65 66 3d 22 6c 61 6e 67 5f 69 6e 73 65 72 74  ref="lang_insert
1500: 2e 68 74 6d 6c 22 3e 49 4e 53 45 52 54 3c 2f 61  .html">INSERT</a
1510: 3e 2c 20 61 6e 64 20 3c 61 20 68 72 65 66 3d 22  >, and <a href="
1520: 6c 61 6e 67 5f 75 70 64 61 74 65 2e 68 74 6d 6c  lang_update.html
1530: 22 3e 55 50 44 41 54 45 3c 2f 61 3e 20 63 6f 6d  ">UPDATE</a> com
1540: 6d 61 6e 64 73 2e 0a 54 68 65 20 3c 61 20 68 72  mands..The <a hr
1550: 65 66 3d 22 6c 61 6e 67 5f 64 72 6f 70 74 61 62  ef="lang_droptab
1560: 6c 65 2e 68 74 6d 6c 22 3e 44 52 4f 50 20 54 41  le.html">DROP TA
1570: 42 4c 45 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20  BLE</a> command 
1580: 77 6f 72 6b 73 20 6f 6e 20 73 74 61 74 69 73 74  works on statist
1590: 69 63 73 20 74 61 62 6c 65 73 0a 61 73 20 6f 66  ics tables.as of
15a0: 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20   SQLite version 
15b0: 33 2e 37 2e 39 2e 20 28 32 30 31 31 2d 31 31 2d  3.7.9. (2011-11-
15c0: 30 31 29 0a 54 68 65 20 3c 61 20 68 72 65 66 3d  01).The <a href=
15d0: 22 6c 61 6e 67 5f 61 6c 74 65 72 74 61 62 6c 65  "lang_altertable
15e0: 2e 68 74 6d 6c 22 3e 41 4c 54 45 52 20 54 41 42  .html">ALTER TAB
15f0: 4c 45 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 64  LE</a> command d
1600: 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e 20  oes not work on 
1610: 73 74 61 74 69 73 74 69 63 73 20 74 61 62 6c 65  statistics table
1620: 73 2e 0a 41 70 70 72 6f 70 72 69 61 74 65 20 63  s..Appropriate c
1630: 61 72 65 20 73 68 6f 75 6c 64 20 62 65 20 75 73  are should be us
1640: 65 64 20 77 68 65 6e 20 63 68 61 6e 67 69 6e 67  ed when changing
1650: 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20   the content of 
1660: 74 68 65 20 73 74 61 74 69 73 74 69 63 73 0a 74  the statistics.t
1670: 61 62 6c 65 73 20 61 73 20 69 6e 76 61 6c 69 64  ables as invalid
1680: 20 63 6f 6e 74 65 6e 74 20 63 61 6e 20 63 61 75   content can cau
1690: 73 65 20 53 51 4c 69 74 65 20 74 6f 20 73 65 6c  se SQLite to sel
16a0: 65 63 74 20 69 6e 65 66 66 69 63 69 65 6e 74 0a  ect inefficient.
16b0: 71 75 65 72 79 20 70 6c 61 6e 73 2e 20 20 47 65  query plans.  Ge
16c0: 6e 65 72 61 6c 6c 79 20 73 70 65 61 6b 69 6e 67  nerally speaking
16d0: 2c 20 6f 6e 65 20 73 68 6f 75 6c 64 20 6e 6f 74  , one should not
16e0: 20 6d 6f 64 69 66 79 20 74 68 65 20 63 6f 6e 74   modify the cont
16f0: 65 6e 74 20 6f 66 0a 74 68 65 20 73 74 61 74 69  ent of.the stati
1700: 73 74 69 63 73 20 74 61 62 6c 65 73 20 62 79 20  stics tables by 
1710: 61 6e 79 20 6d 65 63 68 61 6e 69 73 6d 20 6f 74  any mechanism ot
1720: 68 65 72 20 74 68 61 6e 20 69 6e 76 6f 6b 69 6e  her than invokin
1730: 67 20 74 68 65 0a 41 4e 41 4c 59 5a 45 20 63 6f  g the.ANALYZE co
1740: 6d 6d 61 6e 64 2e 20 20 0a 53 65 65 20 22 3c 61  mmand.  .See "<a
1750: 20 68 72 65 66 3d 22 6f 70 74 6f 76 65 72 76 69   href="optovervi
1760: 65 77 2e 68 74 6d 6c 23 6d 61 6e 63 74 72 6c 22  ew.html#manctrl"
1770: 3e 4d 61 6e 75 61 6c 20 43 6f 6e 74 72 6f 6c 20  >Manual Control 
1780: 4f 66 20 51 75 65 72 79 20 50 6c 61 6e 73 20 55  Of Query Plans U
1790: 73 69 6e 67 20 53 51 4c 49 54 45 5f 53 54 41 54  sing SQLITE_STAT
17a0: 20 54 61 62 6c 65 73 3c 2f 61 3e 22 20 66 6f 72   Tables</a>" for
17b0: 0a 66 75 72 74 68 65 72 20 69 6e 66 6f 72 6d 61  .further informa
17c0: 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 20 53  tion.</p>..<p> S
17d0: 74 61 74 69 73 74 69 63 73 20 67 61 74 68 65 72  tatistics gather
17e0: 65 64 20 62 79 20 41 4e 41 4c 59 5a 45 20 61 72  ed by ANALYZE ar
17f0: 65 20 6e 6f 74 20 61 75 74 6f 6d 61 74 69 63 61  e not automatica
1800: 6c 6c 79 20 75 70 64 61 74 65 64 20 61 73 0a 74  lly updated as.t
1810: 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68  he content of th
1820: 65 20 64 61 74 61 62 61 73 65 20 63 68 61 6e 67  e database chang
1830: 65 73 2e 20 20 49 66 20 74 68 65 20 63 6f 6e 74  es.  If the cont
1840: 65 6e 74 20 6f 66 20 74 68 65 20 64 61 74 61 62  ent of the datab
1850: 61 73 65 0a 63 68 61 6e 67 65 73 20 73 69 67 6e  ase.changes sign
1860: 69 66 69 63 61 6e 74 6c 79 2c 20 6f 72 20 69 66  ificantly, or if
1870: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63   the database sc
1880: 68 65 6d 61 20 63 68 61 6e 67 65 73 2c 20 74 68  hema changes, th
1890: 65 6e 20 6f 6e 65 20 73 68 6f 75 6c 64 0a 63 6f  en one should.co
18a0: 6e 73 69 64 65 72 20 72 65 72 75 6e 6e 69 6e 67  nsider rerunning
18b0: 20 74 68 65 20 41 4e 41 4c 59 5a 45 20 63 6f 6d   the ANALYZE com
18c0: 6d 61 6e 64 20 69 6e 20 6f 72 64 65 72 20 74 6f  mand in order to
18d0: 20 75 70 64 61 74 65 20 74 68 65 20 73 74 61 74   update the stat
18e0: 69 73 74 69 63 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e  istics.</p>..<p>
18f0: 20 54 68 65 20 71 75 65 72 79 20 70 6c 61 6e 6e   The query plann
1900: 65 72 20 6c 6f 61 64 73 20 74 68 65 20 63 6f 6e  er loads the con
1910: 74 65 6e 74 20 6f 66 20 74 68 65 20 73 74 61 74  tent of the stat
1920: 69 73 74 69 63 73 20 74 61 62 6c 65 73 0a 69 6e  istics tables.in
1930: 74 6f 20 6d 65 6d 6f 72 79 20 77 68 65 6e 20 74  to memory when t
1940: 68 65 20 73 63 68 65 6d 61 20 69 73 20 72 65 61  he schema is rea
1950: 64 2e 20 20 48 65 6e 63 65 2c 20 77 68 65 6e 20  d.  Hence, when 
1960: 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 0a 63  an application.c
1970: 68 61 6e 67 65 73 20 74 68 65 20 73 74 61 74 69  hanges the stati
1980: 73 74 69 63 73 20 74 61 62 6c 65 73 20 64 69 72  stics tables dir
1990: 65 63 74 6c 79 2c 20 53 51 4c 69 74 65 20 77 69  ectly, SQLite wi
19a0: 6c 6c 20 6e 6f 74 20 69 6d 6d 65 64 69 61 74 65  ll not immediate
19b0: 6c 79 0a 6e 6f 74 69 63 65 20 74 68 65 20 63 68  ly.notice the ch
19c0: 61 6e 67 65 73 2e 20 41 6e 20 61 70 70 6c 69 63  anges. An applic
19d0: 61 74 69 6f 6e 0a 63 61 6e 20 66 6f 72 63 65 20  ation.can force 
19e0: 74 68 65 20 71 75 65 72 79 20 70 6c 61 6e 6e 65  the query planne
19f0: 72 20 74 6f 20 72 65 72 65 61 64 20 74 68 65 20  r to reread the 
1a00: 73 74 61 74 69 73 74 69 63 73 20 74 61 62 6c 65  statistics table
1a10: 73 20 62 79 20 72 75 6e 6e 69 6e 67 0a 3c 62 3e  s by running.<b>
1a20: 41 4e 41 4c 59 5a 45 20 73 71 6c 69 74 65 5f 6d  ANALYZE sqlite_m
1a30: 61 73 74 65 72 3c 2f 62 3e 2e 20 3c 2f 70 3e 0a  aster</b>. </p>.
1a40: 0a 3c 61 20 6e 61 6d 65 3d 22 61 75 74 6f 61 6e  .<a name="autoan
1a50: 61 6c 79 7a 65 22 3e 3c 2f 61 3e 0a 0a 3c 68 32  alyze"></a>..<h2
1a60: 3e 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 52  >Automatically R
1a70: 75 6e 6e 69 6e 67 20 41 4e 41 4c 59 5a 45 3c 2f  unning ANALYZE</
1a80: 68 32 3e 0a 0a 3c 70 3e 54 68 65 20 3c 61 20 68  h2>..<p>The <a h
1a90: 72 65 66 3d 22 70 72 61 67 6d 61 2e 68 74 6d 6c  ref="pragma.html
1aa0: 23 70 72 61 67 6d 61 5f 6f 70 74 69 6d 69 7a 65  #pragma_optimize
1ab0: 22 3e 50 52 41 47 4d 41 20 6f 70 74 69 6d 69 7a  ">PRAGMA optimiz
1ac0: 65 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 77 69  e</a> command wi
1ad0: 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  ll automatically
1ae0: 20 72 75 6e 20 41 4e 41 4c 59 5a 45 20 6f 6e 20   run ANALYZE on 
1af0: 69 6e 64 69 76 69 64 75 61 6c 0a 74 61 62 6c 65  individual.table
1b00: 73 20 6f 6e 20 61 6e 20 61 73 2d 6e 65 65 64 65  s on an as-neede
1b10: 64 20 62 61 73 69 73 2e 20 20 54 68 65 20 72 65  d basis.  The re
1b20: 63 6f 6d 6d 65 6e 64 65 64 20 70 72 61 63 74 69  commended practi
1b30: 63 65 20 69 73 20 66 6f 72 20 61 70 70 6c 69 63  ce is for applic
1b40: 61 74 69 6f 6e 73 0a 74 6f 20 69 6e 76 6f 6b 65  ations.to invoke
1b50: 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 70 72   the <a href="pr
1b60: 61 67 6d 61 2e 68 74 6d 6c 23 70 72 61 67 6d 61  agma.html#pragma
1b70: 5f 6f 70 74 69 6d 69 7a 65 22 3e 50 52 41 47 4d  _optimize">PRAGM
1b80: 41 20 6f 70 74 69 6d 69 7a 65 3c 2f 61 3e 20 73  A optimize</a> s
1b90: 74 61 74 65 6d 65 6e 74 20 6a 75 73 74 20 62 65  tatement just be
1ba0: 66 6f 72 65 20 63 6c 6f 73 69 6e 67 20 65 61 63  fore closing eac
1bb0: 68 20 64 61 74 61 62 61 73 65 0a 63 6f 6e 6e 65  h database.conne
1bc0: 63 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45  ction.</p>..<p>E
1bd0: 61 63 68 20 53 51 4c 69 74 65 20 3c 61 20 68 72  ach SQLite <a hr
1be0: 65 66 3d 22 63 33 72 65 66 2f 73 71 6c 69 74 65  ef="c3ref/sqlite
1bf0: 33 2e 68 74 6d 6c 22 3e 64 61 74 61 62 61 73 65  3.html">database
1c00: 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 61 3e 20   connection</a> 
1c10: 72 65 63 6f 72 64 73 20 63 61 73 65 73 20 77 68  records cases wh
1c20: 65 6e 20 74 68 65 20 71 75 65 72 79 20 70 6c 61  en the query pla
1c30: 6e 6e 65 72 20 77 6f 75 6c 64 0a 62 65 6e 65 66  nner would.benef
1c40: 69 74 20 66 72 6f 6d 20 68 61 76 69 6e 67 20 61  it from having a
1c50: 63 63 75 72 61 74 65 20 72 65 73 75 6c 74 73 20  ccurate results 
1c60: 6f 66 20 41 4e 41 4c 59 5a 45 20 61 74 20 68 61  of ANALYZE at ha
1c70: 6e 64 2e 20 20 54 68 65 73 65 20 72 65 63 6f 72  nd.  These recor
1c80: 64 73 0a 61 72 65 20 68 65 6c 64 20 69 6e 20 6d  ds.are held in m
1c90: 65 6d 6f 72 79 20 61 6e 64 20 61 63 63 75 6d 75  emory and accumu
1ca0: 6c 61 74 65 20 6f 76 65 72 20 74 68 65 20 6c 69  late over the li
1cb0: 66 65 20 6f 66 20 61 20 64 61 74 61 62 61 73 65  fe of a database
1cc0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 54 68 65   connection..The
1cd0: 20 3c 61 20 68 72 65 66 3d 22 70 72 61 67 6d 61   <a href="pragma
1ce0: 2e 68 74 6d 6c 23 70 72 61 67 6d 61 5f 6f 70 74  .html#pragma_opt
1cf0: 69 6d 69 7a 65 22 3e 50 52 41 47 4d 41 20 6f 70  imize">PRAGMA op
1d00: 74 69 6d 69 7a 65 3c 2f 61 3e 20 63 6f 6d 6d 61  timize</a> comma
1d10: 6e 64 20 6c 6f 6f 6b 73 20 61 74 20 74 68 6f 73  nd looks at thos
1d20: 65 20 72 65 63 6f 72 64 73 20 61 6e 64 20 72 75  e records and ru
1d30: 6e 73 20 41 4e 41 4c 59 5a 45 20 6f 6e 20 6f 6e  ns ANALYZE on on
1d40: 6c 79 0a 74 68 6f 73 65 20 74 61 62 6c 65 73 20  ly.those tables 
1d50: 66 6f 72 20 77 68 69 63 68 20 6e 65 77 20 6f 72  for which new or
1d60: 20 75 70 64 61 74 65 64 20 41 4e 41 4c 59 5a 45   updated ANALYZE
1d70: 20 64 61 74 61 20 73 65 65 6d 73 20 6c 69 6b 65   data seems like
1d80: 6c 79 20 74 6f 20 62 65 20 75 73 65 66 75 6c 2e  ly to be useful.
1d90: 0a 49 6e 20 6d 6f 73 74 20 63 61 73 65 73 20 3c  .In most cases <
1da0: 61 20 68 72 65 66 3d 22 70 72 61 67 6d 61 2e 68  a href="pragma.h
1db0: 74 6d 6c 23 70 72 61 67 6d 61 5f 6f 70 74 69 6d  tml#pragma_optim
1dc0: 69 7a 65 22 3e 50 52 41 47 4d 41 20 6f 70 74 69  ize">PRAGMA opti
1dd0: 6d 69 7a 65 3c 2f 61 3e 20 77 69 6c 6c 20 6e 6f  mize</a> will no
1de0: 74 20 72 75 6e 20 41 4e 41 4c 59 5a 45 2c 20 62  t run ANALYZE, b
1df0: 75 74 20 69 74 20 77 69 6c 6c 20 6f 63 63 61 73  ut it will occas
1e00: 69 6f 6e 61 6c 6c 79 0a 64 6f 20 73 6f 20 65 69  ionally.do so ei
1e10: 74 68 65 72 20 66 6f 72 20 74 61 62 6c 65 73 20  ther for tables 
1e20: 74 68 61 74 20 68 61 76 65 20 6e 65 76 65 72 20  that have never 
1e30: 62 65 66 6f 72 65 20 62 65 65 6e 20 61 6e 61 6c  before been anal
1e40: 79 7a 65 64 2c 20 6f 72 20 66 6f 72 20 74 61 62  yzed, or for tab
1e50: 6c 65 73 0a 74 68 61 74 20 68 61 76 65 20 67 72  les.that have gr
1e60: 6f 77 6e 20 73 69 67 6e 69 66 69 63 61 6e 74 6c  own significantl
1e70: 79 20 73 69 6e 63 65 20 74 68 65 79 20 77 65 72  y since they wer
1e80: 65 20 6c 61 73 74 20 61 6e 61 6c 79 7a 65 64 2e  e last analyzed.
1e90: 3c 2f 70 3e 0a 0a 3c 70 3e 53 69 6e 63 65 20 74  </p>..<p>Since t
1ea0: 68 65 20 61 63 74 69 6f 6e 73 20 6f 66 20 3c 61  he actions of <a
1eb0: 20 68 72 65 66 3d 22 70 72 61 67 6d 61 2e 68 74   href="pragma.ht
1ec0: 6d 6c 23 70 72 61 67 6d 61 5f 6f 70 74 69 6d 69  ml#pragma_optimi
1ed0: 7a 65 22 3e 50 52 41 47 4d 41 20 6f 70 74 69 6d  ze">PRAGMA optim
1ee0: 69 7a 65 3c 2f 61 3e 20 61 72 65 20 64 65 74 65  ize</a> are dete
1ef0: 72 6d 69 6e 65 64 20 74 6f 20 73 6f 6d 65 20 65  rmined to some e
1f00: 78 74 65 6e 74 20 62 79 0a 70 72 69 6f 72 20 71  xtent by.prior q
1f10: 75 65 72 69 65 73 20 74 68 61 74 20 68 61 76 65  ueries that have
1f20: 20 62 65 65 6e 20 65 76 61 6c 75 61 74 65 64 20   been evaluated 
1f30: 6f 6e 20 74 68 65 20 73 61 6d 65 20 64 61 74 61  on the same data
1f40: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c  base connection,
1f50: 20 69 74 0a 69 73 20 72 65 63 6f 6d 6d 65 6e 64   it.is recommend
1f60: 65 64 20 74 68 61 74 20 3c 61 20 68 72 65 66 3d  ed that <a href=
1f70: 22 70 72 61 67 6d 61 2e 68 74 6d 6c 23 70 72 61  "pragma.html#pra
1f80: 67 6d 61 5f 6f 70 74 69 6d 69 7a 65 22 3e 50 52  gma_optimize">PR
1f90: 41 47 4d 41 20 6f 70 74 69 6d 69 7a 65 3c 2f 61  AGMA optimize</a
1fa0: 3e 20 62 65 20 64 65 66 65 72 72 65 64 20 75 6e  > be deferred un
1fb0: 74 69 6c 20 74 68 65 20 64 61 74 61 62 61 73 65  til the database
1fc0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 69 73 20 63   connection.is c
1fd0: 6c 6f 73 69 6e 67 20 61 6e 64 20 68 61 73 20 74  losing and has t
1fe0: 68 75 73 20 68 61 64 20 61 6e 20 6f 70 70 6f 72  hus had an oppor
1ff0: 74 75 6e 69 74 79 20 74 6f 20 61 63 63 75 6d 75  tunity to accumu
2000: 6c 61 74 65 20 61 73 20 6d 75 63 68 20 75 73 61  late as much usa
2010: 67 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 61  ge information.a
2020: 73 20 70 6f 73 73 69 62 6c 65 2e 20 20 49 74 20  s possible.  It 
2030: 69 73 20 61 6c 73 6f 20 72 65 61 73 6f 6e 61 62  is also reasonab
2040: 6c 65 20 74 6f 20 73 65 74 20 61 20 74 69 6d 65  le to set a time
2050: 72 20 74 6f 20 72 75 6e 20 3c 61 20 68 72 65 66  r to run <a href
2060: 3d 22 70 72 61 67 6d 61 2e 68 74 6d 6c 23 70 72  ="pragma.html#pr
2070: 61 67 6d 61 5f 6f 70 74 69 6d 69 7a 65 22 3e 50  agma_optimize">P
2080: 52 41 47 4d 41 20 6f 70 74 69 6d 69 7a 65 3c 2f  RAGMA optimize</
2090: 61 3e 0a 65 76 65 72 79 20 66 65 77 20 68 6f 75  a>.every few hou
20a0: 72 73 2c 20 6f 72 20 65 76 65 72 79 20 66 65 77  rs, or every few
20b0: 20 64 61 79 73 2c 20 66 6f 72 20 64 61 74 61 62   days, for datab
20c0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20  ase connections 
20d0: 74 68 61 74 20 73 74 61 79 20 6f 70 65 6e 0a 66  that stay open.f
20e0: 6f 72 20 61 20 6c 6f 6e 67 20 74 69 6d 65 2e 3c  or a long time.<
20f0: 2f 70 3e 0a 0a 3c 70 3e 41 70 70 6c 69 63 61 74  /p>..<p>Applicat
2100: 69 6f 6e 73 20 74 68 61 74 20 64 65 73 69 72 65  ions that desire
2110: 20 6d 6f 72 65 20 63 6f 6e 74 72 6f 6c 20 63 61   more control ca
2120: 6e 20 72 75 6e 20 3c 61 20 68 72 65 66 3d 22 70  n run <a href="p
2130: 72 61 67 6d 61 2e 68 74 6d 6c 23 70 72 61 67 6d  ragma.html#pragm
2140: 61 5f 6f 70 74 69 6d 69 7a 65 22 3e 50 52 41 47  a_optimize">PRAG
2150: 4d 41 20 6f 70 74 69 6d 69 7a 65 28 30 78 30 33  MA optimize(0x03
2160: 29 3c 2f 61 3e 20 74 6f 20 0a 6f 62 74 61 69 6e  )</a> to .obtain
2170: 20 61 20 6c 69 73 74 20 6f 66 20 41 4e 41 4c 59   a list of ANALY
2180: 5a 45 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74  ZE commands that
2190: 20 53 51 4c 69 74 65 20 74 68 69 6e 6b 73 20 61   SQLite thinks a
21a0: 72 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 74  re appropriate t
21b0: 6f 20 72 75 6e 2c 0a 62 75 74 20 77 69 74 68 6f  o run,.but witho
21c0: 75 74 20 61 63 74 75 61 6c 6c 79 20 72 75 6e 6e  ut actually runn
21d0: 69 6e 67 20 74 68 6f 73 65 20 63 6f 6d 6d 61 6e  ing those comman
21e0: 64 73 2e 20 20 49 66 20 74 68 65 20 72 65 74 75  ds.  If the retu
21f0: 72 6e 65 64 20 73 65 74 20 69 73 20 0a 6e 6f 6e  rned set is .non
2200: 2d 65 6d 70 74 79 2c 20 74 68 65 20 61 70 70 6c  -empty, the appl
2210: 69 63 61 74 69 6f 6e 20 63 61 6e 20 74 68 65 6e  ication can then
2220: 20 6d 61 6b 65 20 61 20 64 65 63 69 73 69 6f 6e   make a decision
2230: 20 61 62 6f 75 74 20 77 68 65 74 68 65 72 20 6f   about whether o
2240: 72 20 6e 6f 74 0a 74 6f 20 72 75 6e 20 74 68 65  r not.to run the
2250: 20 73 75 67 67 65 73 74 65 64 20 41 4e 41 4c 59   suggested ANALY
2260: 5a 45 20 63 6f 6d 6d 61 6e 64 73 2c 20 70 65 72  ZE commands, per
2270: 68 61 70 73 20 61 66 74 65 72 20 70 72 6f 6d 70  haps after promp
2280: 74 69 6e 67 20 74 68 65 20 75 73 65 72 0a 66 6f  ting the user.fo
2290: 72 20 67 75 69 64 61 6e 63 65 2e 3c 2f 70 3e 0a  r guidance.</p>.
22a0: 0a 3c 70 3e 54 68 65 20 3c 61 20 68 72 65 66 3d  .<p>The <a href=
22b0: 22 70 72 61 67 6d 61 2e 68 74 6d 6c 23 70 72 61  "pragma.html#pra
22c0: 67 6d 61 5f 6f 70 74 69 6d 69 7a 65 22 3e 50 52  gma_optimize">PR
22d0: 41 47 4d 41 20 6f 70 74 69 6d 69 7a 65 3c 2f 61  AGMA optimize</a
22e0: 3e 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20 66 69  > command was fi
22f0: 72 73 74 20 69 6e 74 72 6f 64 75 63 65 64 20 77  rst introduced w
2300: 69 74 68 20 0a 53 51 4c 69 74 65 20 33 2e 31 38  ith .SQLite 3.18
2310: 2e 30 20 28 32 30 31 37 2d 30 33 2d 32 38 29 20  .0 (2017-03-28) 
2320: 61 6e 64 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66  and is a no-op f
2330: 6f 72 20 61 6c 6c 20 70 72 69 6f 72 20 72 65 6c  or all prior rel
2340: 65 61 73 65 73 0a 6f 66 20 53 51 4c 69 74 65 2e  eases.of SQLite.
2350: 3c 2f 70 3e 0a 0a 3c 68 32 3e 41 6e 74 69 63 69  </p>..<h2>Antici
2360: 70 61 74 65 64 20 46 75 74 75 72 65 20 45 6e 68  pated Future Enh
2370: 61 6e 63 65 6d 65 6e 74 73 3c 2f 68 32 3e 0a 0a  ancements</h2>..
2380: 3c 70 3e 41 6c 6c 20 65 78 69 73 74 69 6e 67 20  <p>All existing 
2390: 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69  versions of SQLi
23a0: 74 65 20 64 6f 20 61 20 66 75 6c 6c 20 74 61 62  te do a full tab
23b0: 6c 65 20 73 63 61 6e 20 66 6f 72 20 41 4e 41 4c  le scan for ANAL
23c0: 59 5a 45 2e 20 20 54 68 69 73 20 63 61 6e 20 62  YZE.  This can b
23d0: 65 0a 73 6c 6f 77 20 66 6f 72 20 6d 75 6c 74 69  e.slow for multi
23e0: 2d 67 69 67 61 62 79 74 65 20 61 6e 64 20 6c 61  -gigabyte and la
23f0: 72 67 65 72 20 64 61 74 61 62 61 73 65 73 2e 20  rger databases. 
2400: 20 46 75 74 75 72 65 20 76 65 72 73 69 6f 6e 73   Future versions
2410: 20 6f 66 20 53 51 4c 69 74 65 20 6d 69 67 68 74   of SQLite might
2420: 0a 75 73 65 20 72 61 6e 64 6f 6d 20 73 61 6d 70  .use random samp
2430: 6c 69 6e 67 20 72 61 74 68 65 72 20 74 68 61 6e  ling rather than
2440: 20 61 20 66 75 6c 6c 20 74 61 62 6c 65 20 73 63   a full table sc
2450: 61 6e 20 74 6f 20 6f 62 74 61 69 6e 20 65 73 74  an to obtain est
2460: 69 6d 61 74 65 73 20 66 6f 72 20 74 68 65 0a 64  imates for the.d
2470: 61 74 61 62 61 73 65 20 73 68 61 70 65 2c 20 65  atabase shape, e
2480: 73 70 65 63 69 61 6c 6c 79 20 6f 6e 20 6c 61 72  specially on lar
2490: 67 65 72 20 74 61 62 6c 65 73 2e 20 20 54 68 65  ger tables.  The
24a0: 20 72 65 73 75 6c 74 73 20 77 6f 75 6c 64 20 61   results would a
24b0: 70 70 72 6f 78 69 6d 61 74 65 2c 20 62 75 74 20  pproximate, but 
24c0: 0a 77 69 6c 6c 20 62 65 20 63 6c 6f 73 65 20 65  .will be close e
24d0: 6e 6f 75 67 68 20 66 6f 72 20 71 75 65 72 79 20  nough for query 
24e0: 70 6c 61 6e 6e 69 6e 67 20 70 75 72 70 6f 73 65  planning purpose
24f0: 73 2e 20 20 41 73 20 6f 66 20 32 30 31 37 2d 30  s.  As of 2017-0
2500: 33 2d 32 30 2c 20 74 68 69 73 0a 63 6f 6e 63 65  3-20, this.conce
2510: 70 74 20 68 61 73 20 62 65 65 6e 20 74 65 73 74  pt has been test
2520: 65 64 20 69 6e 20 65 78 70 65 72 69 6d 65 6e 74  ed in experiment
2530: 61 6c 20 62 72 61 6e 63 68 65 73 20 61 6e 64 20  al branches and 
2540: 61 70 70 65 61 72 73 20 74 6f 20 77 6f 72 6b 20  appears to work 
2550: 77 65 6c 6c 2c 20 62 75 74 0a 68 61 73 20 6e 6f  well, but.has no
2560: 74 20 62 65 65 6e 20 66 6f 6c 64 65 64 20 69 6e  t been folded in
2570: 74 6f 20 61 6e 20 6f 66 66 69 63 69 61 6c 20 72  to an official r
2580: 65 6c 65 61 73 65 2e 3c 2f 70 3e 0a 0a 0a        elease.</p>...