Documentation Source Text

Hex Artifact Content
Login

Artifact 5d0b18c208bdcd7f29caa0423dd8d6356973b7e4:


0000: 3c 74 69 74 6c 65 3e 43 6f 6d 6d 61 6e 64 20 4c  <title>Command L
0010: 69 6e 65 20 53 68 65 6c 6c 20 46 6f 72 20 53 51  ine Shell For SQ
0020: 4c 69 74 65 3c 2f 74 69 74 6c 65 3e 0a 3c 74 63  Lite</title>.<tc
0030: 6c 3e 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b 43  l>hd_keywords {C
0040: 4c 49 7d 20 7b 43 6f 6d 6d 61 6e 64 20 4c 69 6e  LI} {Command Lin
0050: 65 20 49 6e 74 65 72 66 61 63 65 7d 20 7b 63 6f  e Interface} {co
0060: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 68 65 6c 6c  mmand-line shell
0070: 7d 3c 2f 74 63 6c 3e 0a 0a 3c 68 31 20 61 6c 69  }</tcl>..<h1 ali
0080: 67 6e 3d 63 65 6e 74 65 72 3e 0a 43 6f 6d 6d 61  gn=center>.Comma
0090: 6e 64 20 4c 69 6e 65 20 53 68 65 6c 6c 20 46 6f  nd Line Shell Fo
00a0: 72 20 53 51 4c 69 74 65 0a 3c 2f 68 31 3e 0a 0a  r SQLite.</h1>..
00b0: 3c 70 3e 54 68 65 20 53 51 4c 69 74 65 20 6c 69  <p>The SQLite li
00c0: 62 72 61 72 79 20 69 6e 63 6c 75 64 65 73 20 61  brary includes a
00d0: 20 73 69 6d 70 6c 65 20 63 6f 6d 6d 61 6e 64 2d   simple command-
00e0: 6c 69 6e 65 20 75 74 69 6c 69 74 79 20 6e 61 6d  line utility nam
00f0: 65 64 0a 3c 62 3e 73 71 6c 69 74 65 33 3c 2f 62  ed.<b>sqlite3</b
0100: 3e 20 28 6f 72 20 3c 62 3e 73 71 6c 69 74 65 33  > (or <b>sqlite3
0110: 2e 65 78 65 3c 2f 62 3e 20 6f 6e 20 77 69 6e 64  .exe</b> on wind
0120: 6f 77 73 29 0a 74 68 61 74 20 61 6c 6c 6f 77 73  ows).that allows
0130: 20 74 68 65 20 75 73 65 72 20 74 6f 20 6d 61 6e   the user to man
0140: 75 61 6c 6c 79 20 65 6e 74 65 72 20 61 6e 64 20  ually enter and 
0150: 65 78 65 63 75 74 65 20 53 51 4c 0a 63 6f 6d 6d  execute SQL.comm
0160: 61 6e 64 73 20 61 67 61 69 6e 73 74 20 61 6e 20  ands against an 
0170: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e  SQLite database.
0180: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
0190: 70 72 6f 76 69 64 65 73 20 61 20 62 72 69 65 66  provides a brief
01a0: 0a 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20 6f 6e  .introduction on
01b0: 20 68 6f 77 20 74 6f 20 75 73 65 20 74 68 65 20   how to use the 
01c0: 3c 62 3e 73 71 6c 69 74 65 33 3c 2f 62 3e 20 70  <b>sqlite3</b> p
01d0: 72 6f 67 72 61 6d 2e 0a 0a 3c 68 33 3e 47 65 74  rogram...<h3>Get
01e0: 74 69 6e 67 20 53 74 61 72 74 65 64 3c 2f 68 33  ting Started</h3
01f0: 3e 0a 0a 3c 70 3e 54 6f 20 73 74 61 72 74 20 74  >..<p>To start t
0200: 68 65 20 3c 62 3e 73 71 6c 69 74 65 33 3c 2f 62  he <b>sqlite3</b
0210: 3e 20 70 72 6f 67 72 61 6d 2c 20 6a 75 73 74 20  > program, just 
0220: 74 79 70 65 20 22 73 71 6c 69 74 65 33 22 20 66  type "sqlite3" f
0230: 6f 6c 6c 6f 77 65 64 20 62 79 0a 74 68 65 20 6e  ollowed by.the n
0240: 61 6d 65 20 74 68 65 20 66 69 6c 65 20 74 68 61  ame the file tha
0250: 74 20 68 6f 6c 64 73 20 74 68 65 20 53 51 4c 69  t holds the SQLi
0260: 74 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 66  te database.  If
0270: 20 74 68 65 20 66 69 6c 65 20 64 6f 65 73 0a 6e   the file does.n
0280: 6f 74 20 65 78 69 73 74 2c 20 61 20 6e 65 77 20  ot exist, a new 
0290: 6f 6e 65 20 69 73 20 63 72 65 61 74 65 64 20 61  one is created a
02a0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 54 68  utomatically..Th
02b0: 65 20 3c 62 3e 73 71 6c 69 74 65 33 3c 2f 62 3e  e <b>sqlite3</b>
02c0: 20 70 72 6f 67 72 61 6d 20 77 69 6c 6c 0a 74 68   program will.th
02d0: 65 6e 20 70 72 6f 6d 70 74 20 79 6f 75 20 74 6f  en prompt you to
02e0: 20 65 6e 74 65 72 20 53 51 4c 2e 20 20 54 79 70   enter SQL.  Typ
02f0: 65 20 69 6e 20 53 51 4c 20 73 74 61 74 65 6d 65  e in SQL stateme
0300: 6e 74 73 20 28 74 65 72 6d 69 6e 61 74 65 64 20  nts (terminated 
0310: 62 79 20 61 0a 73 65 6d 69 63 6f 6c 6f 6e 29 2c  by a.semicolon),
0320: 20 70 72 65 73 73 20 22 45 6e 74 65 72 22 20 61   press "Enter" a
0330: 6e 64 20 74 68 65 20 53 51 4c 20 77 69 6c 6c 20  nd the SQL will 
0340: 62 65 20 65 78 65 63 75 74 65 64 2e 3c 2f 70 3e  be executed.</p>
0350: 0a 0a 3c 70 3e 46 6f 72 20 65 78 61 6d 70 6c 65  ..<p>For example
0360: 2c 20 74 6f 20 63 72 65 61 74 65 20 61 20 6e 65  , to create a ne
0370: 77 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  w SQLite databas
0380: 65 20 6e 61 6d 65 64 20 22 65 78 31 22 20 0a 77  e named "ex1" .w
0390: 69 74 68 20 61 20 73 69 6e 67 6c 65 20 74 61 62  ith a single tab
03a0: 6c 65 20 6e 61 6d 65 64 20 22 74 62 6c 31 22 2c  le named "tbl1",
03b0: 20 79 6f 75 20 6d 69 67 68 74 20 64 6f 20 74 68   you might do th
03c0: 69 73 3a 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 0a 70  is:</p>..<tcl>.p
03d0: 72 6f 63 20 43 6f 64 65 20 7b 62 6f 64 79 7d 20  roc Code {body} 
03e0: 7b 0a 20 20 68 64 5f 70 75 74 73 20 7b 3c 62 6c  {.  hd_puts {<bl
03f0: 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 7d 0a  ockquote><pre>}.
0400: 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 26    regsub -all {&
0410: 7d 20 5b 73 74 72 69 6e 67 20 74 72 69 6d 20 24  } [string trim $
0420: 62 6f 64 79 5d 20 7b 5c 26 61 6d 70 3b 7d 20 62  body] {\&amp;} b
0430: 6f 64 79 0a 20 20 72 65 67 73 75 62 20 2d 61 6c  ody.  regsub -al
0440: 6c 20 7b 3e 7d 20 24 62 6f 64 79 20 7b 5c 26 67  l {>} $body {\&g
0450: 74 3b 7d 20 62 6f 64 79 0a 20 20 72 65 67 73 75  t;} body.  regsu
0460: 62 20 2d 61 6c 6c 20 7b 3c 7d 20 24 62 6f 64 79  b -all {<} $body
0470: 20 7b 5c 26 6c 74 3b 7d 20 62 6f 64 79 0a 20 20   {\&lt;} body.  
0480: 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 5c 28 5c  regsub -all {\(\
0490: 28 5c 28 7d 20 24 62 6f 64 79 20 7b 3c 62 3e 7d  (\(} $body {<b>}
04a0: 20 62 6f 64 79 0a 20 20 72 65 67 73 75 62 20 2d   body.  regsub -
04b0: 61 6c 6c 20 7b 5c 29 5c 29 5c 29 7d 20 24 62 6f  all {\)\)\)} $bo
04c0: 64 79 20 7b 3c 2f 62 3e 7d 20 62 6f 64 79 0a 20  dy {</b>} body. 
04d0: 20 23 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 20   #regsub -all { 
04e0: 7d 20 24 62 6f 64 79 20 7b 5c 26 6e 62 73 70 3b  } $body {\&nbsp;
04f0: 7d 20 62 6f 64 79 0a 20 20 23 72 65 67 73 75 62  } body.  #regsub
0500: 20 2d 61 6c 6c 20 5c 6e 20 24 62 6f 64 79 20 3c   -all \n $body <
0510: 62 72 3e 5c 6e 20 62 6f 64 79 0a 20 20 68 64 5f  br>\n body.  hd_
0520: 70 75 74 73 20 24 62 6f 64 79 0a 20 20 68 64 5f  puts $body.  hd_
0530: 70 75 74 73 20 7b 3c 2f 70 72 65 3e 3c 2f 62 6c  puts {</pre></bl
0540: 6f 63 6b 71 75 6f 74 65 3e 7d 0a 7d 0a 0a 43 6f  ockquote>}.}..Co
0550: 64 65 20 7b 0a 24 20 28 28 28 73 71 6c 69 74 65  de {.$ (((sqlite
0560: 33 20 65 78 31 29 29 29 0a 53 51 4c 69 74 65 20  3 ex1))).SQLite 
0570: 76 65 72 73 69 6f 6e 20 33 2e 36 2e 31 31 0a 45  version 3.6.11.E
0580: 6e 74 65 72 20 22 2e 68 65 6c 70 22 20 66 6f 72  nter ".help" for
0590: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 0a 45 6e   instructions.En
05a0: 74 65 72 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ter SQL statemen
05b0: 74 73 20 74 65 72 6d 69 6e 61 74 65 64 20 77 69  ts terminated wi
05c0: 74 68 20 61 20 22 3b 22 0a 73 71 6c 69 74 65 3e  th a ";".sqlite>
05d0: 20 28 28 28 63 72 65 61 74 65 20 74 61 62 6c 65   (((create table
05e0: 20 74 62 6c 31 28 6f 6e 65 20 76 61 72 63 68 61   tbl1(one varcha
05f0: 72 28 31 30 29 2c 20 74 77 6f 20 73 6d 61 6c 6c  r(10), two small
0600: 69 6e 74 29 3b 29 29 29 0a 73 71 6c 69 74 65 3e  int);))).sqlite>
0610: 20 28 28 28 69 6e 73 65 72 74 20 69 6e 74 6f 20   (((insert into 
0620: 74 62 6c 31 20 76 61 6c 75 65 73 28 27 68 65 6c  tbl1 values('hel
0630: 6c 6f 21 27 2c 31 30 29 3b 29 29 29 0a 73 71 6c  lo!',10);))).sql
0640: 69 74 65 3e 20 28 28 28 69 6e 73 65 72 74 20 69  ite> (((insert i
0650: 6e 74 6f 20 74 62 6c 31 20 76 61 6c 75 65 73 28  nto tbl1 values(
0660: 27 67 6f 6f 64 62 79 65 27 2c 20 32 30 29 3b 29  'goodbye', 20);)
0670: 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 73 65  )).sqlite> (((se
0680: 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62 6c 31  lect * from tbl1
0690: 3b 29 29 29 0a 68 65 6c 6c 6f 21 7c 31 30 0a 67  ;))).hello!|10.g
06a0: 6f 6f 64 62 79 65 7c 32 30 0a 73 71 6c 69 74 65  oodbye|20.sqlite
06b0: 3e 0a 7d 0a 3c 2f 74 63 6c 3e 0a 0a 3c 70 3e 59  >.}.</tcl>..<p>Y
06c0: 6f 75 20 63 61 6e 20 74 65 72 6d 69 6e 61 74 65  ou can terminate
06d0: 20 74 68 65 20 73 71 6c 69 74 65 33 20 70 72 6f   the sqlite3 pro
06e0: 67 72 61 6d 20 62 79 20 74 79 70 69 6e 67 20 79  gram by typing y
06f0: 6f 75 72 20 73 79 73 74 65 6d 73 0a 45 6e 64 2d  our systems.End-
0700: 4f 66 2d 46 69 6c 65 20 63 68 61 72 61 63 74 65  Of-File characte
0710: 72 20 28 75 73 75 61 6c 6c 79 20 61 20 43 6f 6e  r (usually a Con
0720: 74 72 6f 6c 2d 44 29 2e 20 20 55 73 65 20 74 68  trol-D).  Use th
0730: 65 20 69 6e 74 65 72 72 75 70 74 0a 63 68 61 72  e interrupt.char
0740: 61 63 74 65 72 20 28 75 73 75 61 6c 6c 79 20 61  acter (usually a
0750: 20 43 6f 6e 74 72 6f 6c 2d 43 29 20 74 6f 20 73   Control-C) to s
0760: 74 6f 70 20 61 20 6c 6f 6e 67 2d 72 75 6e 6e 69  top a long-runni
0770: 6e 67 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ng SQL statement
0780: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4d 61 6b 65 20 73  .</p>..<p>Make s
0790: 75 72 65 20 79 6f 75 20 74 79 70 65 20 61 20 73  ure you type a s
07a0: 65 6d 69 63 6f 6c 6f 6e 20 61 74 20 74 68 65 20  emicolon at the 
07b0: 65 6e 64 20 6f 66 20 65 61 63 68 20 53 51 4c 20  end of each SQL 
07c0: 63 6f 6d 6d 61 6e 64 21 0a 54 68 65 20 73 71 6c  command!.The sql
07d0: 69 74 65 33 20 70 72 6f 67 72 61 6d 20 6c 6f 6f  ite3 program loo
07e0: 6b 73 20 66 6f 72 20 61 20 73 65 6d 69 63 6f 6c  ks for a semicol
07f0: 6f 6e 20 74 6f 20 6b 6e 6f 77 20 77 68 65 6e 20  on to know when 
0800: 79 6f 75 72 20 53 51 4c 20 63 6f 6d 6d 61 6e 64  your SQL command
0810: 20 69 73 0a 63 6f 6d 70 6c 65 74 65 2e 20 20 49   is.complete.  I
0820: 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 73  f you omit the s
0830: 65 6d 69 63 6f 6c 6f 6e 2c 20 73 71 6c 69 74 65  emicolon, sqlite
0840: 33 20 77 69 6c 6c 20 67 69 76 65 20 79 6f 75 20  3 will give you 
0850: 61 0a 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 20 70  a.continuation p
0860: 72 6f 6d 70 74 20 61 6e 64 20 77 61 69 74 20 66  rompt and wait f
0870: 6f 72 20 79 6f 75 20 74 6f 20 65 6e 74 65 72 20  or you to enter 
0880: 6d 6f 72 65 20 74 65 78 74 20 74 6f 20 62 65 0a  more text to be.
0890: 61 64 64 65 64 20 74 6f 20 74 68 65 20 63 75 72  added to the cur
08a0: 72 65 6e 74 20 53 51 4c 20 63 6f 6d 6d 61 6e 64  rent SQL command
08b0: 2e 20 20 54 68 69 73 20 66 65 61 74 75 72 65 20  .  This feature 
08c0: 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 0a 65 6e  allows you to.en
08d0: 74 65 72 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 73  ter SQL commands
08e0: 20 74 68 61 74 20 73 70 61 6e 20 6d 75 6c 74 69   that span multi
08f0: 70 6c 65 20 6c 69 6e 65 73 2e 20 20 46 6f 72 20  ple lines.  For 
0900: 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 0a 3c  example:</p>...<
0910: 74 63 6c 3e 43 6f 64 65 20 7b 0a 73 71 6c 69 74  tcl>Code {.sqlit
0920: 65 3e 20 28 28 28 43 52 45 41 54 45 20 54 41 42  e> (((CREATE TAB
0930: 4c 45 20 74 62 6c 32 20 28 29 29 29 0a 20 20 20  LE tbl2 ())).   
0940: 2e 2e 2e 3e 20 28 28 28 20 20 66 31 20 76 61 72  ...> (((  f1 var
0950: 63 68 61 72 28 33 30 29 20 70 72 69 6d 61 72 79  char(30) primary
0960: 20 6b 65 79 2c 29 29 29 0a 20 20 20 2e 2e 2e 3e   key,))).   ...>
0970: 20 28 28 28 20 20 66 32 20 74 65 78 74 2c 29 29   (((  f2 text,))
0980: 29 0a 20 20 20 2e 2e 2e 3e 20 28 28 28 20 20 66  ).   ...> (((  f
0990: 33 20 72 65 61 6c 29 29 29 0a 20 20 20 2e 2e 2e  3 real))).   ...
09a0: 3e 20 28 28 28 29 3b 29 29 29 0a 73 71 6c 69 74  > ((();))).sqlit
09b0: 65 3e 20 0a 7d 3c 2f 74 63 6c 3e 0a 0a 3c 68 33  e> .}</tcl>..<h3
09c0: 3e 41 73 69 64 65 3a 20 51 75 65 72 79 69 6e 67  >Aside: Querying
09d0: 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 53 54   the SQLITE_MAST
09e0: 45 52 20 74 61 62 6c 65 3c 2f 68 33 3e 0a 0a 3c  ER table</h3>..<
09f0: 70 3e 54 68 65 20 64 61 74 61 62 61 73 65 20 73  p>The database s
0a00: 63 68 65 6d 61 20 69 6e 20 61 6e 20 53 51 4c 69  chema in an SQLi
0a10: 74 65 20 64 61 74 61 62 61 73 65 20 69 73 20 73  te database is s
0a20: 74 6f 72 65 64 20 69 6e 0a 61 20 73 70 65 63 69  tored in.a speci
0a30: 61 6c 20 74 61 62 6c 65 20 6e 61 6d 65 64 20 22  al table named "
0a40: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 2e 0a  sqlite_master"..
0a50: 59 6f 75 20 63 61 6e 20 65 78 65 63 75 74 65 20  You can execute 
0a60: 22 53 45 4c 45 43 54 22 20 73 74 61 74 65 6d 65  "SELECT" stateme
0a70: 6e 74 73 20 61 67 61 69 6e 73 74 20 74 68 65 0a  nts against the.
0a80: 73 70 65 63 69 61 6c 20 73 71 6c 69 74 65 5f 6d  special sqlite_m
0a90: 61 73 74 65 72 20 74 61 62 6c 65 20 6a 75 73 74  aster table just
0aa0: 20 6c 69 6b 65 20 61 6e 79 20 6f 74 68 65 72 20   like any other 
0ab0: 74 61 62 6c 65 0a 69 6e 20 61 6e 20 53 51 4c 69  table.in an SQLi
0ac0: 74 65 20 64 61 74 61 62 61 73 65 2e 20 20 46 6f  te database.  Fo
0ad0: 72 20 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a  r example:</p>..
0ae0: 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a 24 20 28 28  <tcl>Code {.$ ((
0af0: 28 73 71 6c 69 74 65 33 20 65 78 31 29 29 29 0a  (sqlite3 ex1))).
0b00: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
0b10: 2e 36 2e 31 31 0a 45 6e 74 65 72 20 22 2e 68 65  .6.11.Enter ".he
0b20: 6c 70 22 20 66 6f 72 20 69 6e 73 74 72 75 63 74  lp" for instruct
0b30: 69 6f 6e 73 0a 73 71 6c 69 74 65 3e 20 28 28 28  ions.sqlite> (((
0b40: 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 73 71  select * from sq
0b50: 6c 69 74 65 5f 6d 61 73 74 65 72 3b 29 29 29 0a  lite_master;))).
0b60: 20 20 20 20 74 79 70 65 20 3d 20 74 61 62 6c 65      type = table
0b70: 0a 20 20 20 20 6e 61 6d 65 20 3d 20 74 62 6c 31  .    name = tbl1
0b80: 0a 74 62 6c 5f 6e 61 6d 65 20 3d 20 74 62 6c 31  .tbl_name = tbl1
0b90: 0a 72 6f 6f 74 70 61 67 65 20 3d 20 33 0a 20 20  .rootpage = 3.  
0ba0: 20 20 20 73 71 6c 20 3d 20 63 72 65 61 74 65 20     sql = create 
0bb0: 74 61 62 6c 65 20 74 62 6c 31 28 6f 6e 65 20 76  table tbl1(one v
0bc0: 61 72 63 68 61 72 28 31 30 29 2c 20 74 77 6f 20  archar(10), two 
0bd0: 73 6d 61 6c 6c 69 6e 74 29 0a 73 71 6c 69 74 65  smallint).sqlite
0be0: 3e 0a 7d 3c 2f 74 63 6c 3e 0a 0a 3c 70 3e 0a 42  >.}</tcl>..<p>.B
0bf0: 75 74 20 79 6f 75 20 63 61 6e 6e 6f 74 20 65 78  ut you cannot ex
0c00: 65 63 75 74 65 20 44 52 4f 50 20 54 41 42 4c 45  ecute DROP TABLE
0c10: 2c 20 55 50 44 41 54 45 2c 20 49 4e 53 45 52 54  , UPDATE, INSERT
0c20: 20 6f 72 20 44 45 4c 45 54 45 20 61 67 61 69 6e   or DELETE again
0c30: 73 74 0a 74 68 65 20 73 71 6c 69 74 65 5f 6d 61  st.the sqlite_ma
0c40: 73 74 65 72 20 74 61 62 6c 65 2e 20 20 54 68 65  ster table.  The
0c50: 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 0a 74   sqlite_master.t
0c60: 61 62 6c 65 20 69 73 20 75 70 64 61 74 65 64 20  able is updated 
0c70: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 73  automatically as
0c80: 20 79 6f 75 20 63 72 65 61 74 65 20 6f 72 20 64   you create or d
0c90: 72 6f 70 20 74 61 62 6c 65 73 20 61 6e 64 0a 69  rop tables and.i
0ca0: 6e 64 69 63 65 73 20 66 72 6f 6d 20 74 68 65 20  ndices from the 
0cb0: 64 61 74 61 62 61 73 65 2e 20 20 59 6f 75 20 63  database.  You c
0cc0: 61 6e 20 6e 6f 74 20 6d 61 6b 65 20 6d 61 6e 75  an not make manu
0cd0: 61 6c 20 63 68 61 6e 67 65 73 0a 74 6f 20 74 68  al changes.to th
0ce0: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  e sqlite_master 
0cf0: 74 61 62 6c 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e  table..</p>..<p>
0d00: 0a 54 68 65 20 73 63 68 65 6d 61 20 66 6f 72 20  .The schema for 
0d10: 54 45 4d 50 4f 52 41 52 59 20 74 61 62 6c 65 73  TEMPORARY tables
0d20: 20 69 73 20 6e 6f 74 20 73 74 6f 72 65 64 20 69   is not stored i
0d30: 6e 20 74 68 65 20 22 73 71 6c 69 74 65 5f 6d 61  n the "sqlite_ma
0d40: 73 74 65 72 22 20 74 61 62 6c 65 0a 73 69 6e 63  ster" table.sinc
0d50: 65 20 54 45 4d 50 4f 52 41 52 59 20 74 61 62 6c  e TEMPORARY tabl
0d60: 65 73 20 61 72 65 20 6e 6f 74 20 76 69 73 69 62  es are not visib
0d70: 6c 65 20 74 6f 20 61 70 70 6c 69 63 61 74 69 6f  le to applicatio
0d80: 6e 73 20 6f 74 68 65 72 20 74 68 61 6e 20 74 68  ns other than th
0d90: 65 0a 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 68  e.application th
0da0: 61 74 20 63 72 65 61 74 65 64 20 74 68 65 20 74  at created the t
0db0: 61 62 6c 65 2e 20 20 54 68 65 20 73 63 68 65 6d  able.  The schem
0dc0: 61 20 66 6f 72 20 54 45 4d 50 4f 52 41 52 59 20  a for TEMPORARY 
0dd0: 74 61 62 6c 65 73 0a 69 73 20 73 74 6f 72 65 64  tables.is stored
0de0: 20 69 6e 20 61 6e 6f 74 68 65 72 20 73 70 65 63   in another spec
0df0: 69 61 6c 20 74 61 62 6c 65 20 6e 61 6d 65 64 20  ial table named 
0e00: 22 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73  "sqlite_temp_mas
0e10: 74 65 72 22 2e 20 20 54 68 65 0a 22 73 71 6c 69  ter".  The."sqli
0e20: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 22 20  te_temp_master" 
0e30: 74 61 62 6c 65 20 69 73 20 74 65 6d 70 6f 72 61  table is tempora
0e40: 72 79 20 69 74 73 65 6c 66 2e 0a 3c 2f 70 3e 0a  ry itself..</p>.
0e50: 0a 3c 68 33 3e 53 70 65 63 69 61 6c 20 63 6f 6d  .<h3>Special com
0e60: 6d 61 6e 64 73 20 74 6f 20 73 71 6c 69 74 65 33  mands to sqlite3
0e70: 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 4d 6f 73 74 20  </h3>..<p>.Most 
0e80: 6f 66 20 74 68 65 20 74 69 6d 65 2c 20 73 71 6c  of the time, sql
0e90: 69 74 65 33 20 6a 75 73 74 20 72 65 61 64 73 20  ite3 just reads 
0ea0: 6c 69 6e 65 73 20 6f 66 20 69 6e 70 75 74 20 61  lines of input a
0eb0: 6e 64 20 70 61 73 73 65 73 20 74 68 65 6d 0a 6f  nd passes them.o
0ec0: 6e 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65 20  n to the SQLite 
0ed0: 6c 69 62 72 61 72 79 20 66 6f 72 20 65 78 65 63  library for exec
0ee0: 75 74 69 6f 6e 2e 0a 42 75 74 20 69 66 20 61 6e  ution..But if an
0ef0: 20 69 6e 70 75 74 20 6c 69 6e 65 20 62 65 67 69   input line begi
0f00: 6e 73 20 77 69 74 68 20 61 20 64 6f 74 20 28 22  ns with a dot ("
0f10: 2e 22 29 2c 20 74 68 65 6e 0a 74 68 61 74 20 6c  ."), then.that l
0f20: 69 6e 65 20 69 73 20 69 6e 74 65 72 63 65 70 74  ine is intercept
0f30: 65 64 20 61 6e 64 20 69 6e 74 65 72 70 72 65 74  ed and interpret
0f40: 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 65  ed by the sqlite
0f50: 33 20 70 72 6f 67 72 61 6d 20 69 74 73 65 6c 66  3 program itself
0f60: 2e 0a 54 68 65 73 65 20 22 64 6f 74 20 63 6f 6d  ..These "dot com
0f70: 6d 61 6e 64 73 22 20 61 72 65 20 74 79 70 69 63  mands" are typic
0f80: 61 6c 6c 79 20 75 73 65 64 20 74 6f 20 63 68 61  ally used to cha
0f90: 6e 67 65 20 74 68 65 20 6f 75 74 70 75 74 20 66  nge the output f
0fa0: 6f 72 6d 61 74 0a 6f 66 20 71 75 65 72 69 65 73  ormat.of queries
0fb0: 2c 20 6f 72 20 74 6f 20 65 78 65 63 75 74 65 20  , or to execute 
0fc0: 63 65 72 74 61 69 6e 20 70 72 65 70 61 63 6b 61  certain prepacka
0fd0: 67 65 64 20 71 75 65 72 79 20 73 74 61 74 65 6d  ged query statem
0fe0: 65 6e 74 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  ents..</p>..<p>.
0ff0: 46 6f 72 20 61 20 6c 69 73 74 69 6e 67 20 6f 66  For a listing of
1000: 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 64   the available d
1010: 6f 74 20 63 6f 6d 6d 61 6e 64 73 2c 20 79 6f 75  ot commands, you
1020: 20 63 61 6e 20 65 6e 74 65 72 20 22 2e 68 65 6c   can enter ".hel
1030: 70 22 0a 61 74 20 61 6e 79 20 74 69 6d 65 2e 20  p".at any time. 
1040: 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 3c 2f   For example:.</
1050: 70 3e 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a  p>..<tcl>Code {.
1060: 73 71 6c 69 74 65 3e 20 28 28 28 2e 68 65 6c 70  sqlite> (((.help
1070: 29 29 29 0a 2e 62 61 63 6b 75 70 20 3f 44 42 3f  )))..backup ?DB?
1080: 20 46 49 4c 45 20 20 20 20 20 20 42 61 63 6b 75   FILE      Backu
1090: 70 20 44 42 20 28 64 65 66 61 75 6c 74 20 22 6d  p DB (default "m
10a0: 61 69 6e 22 29 20 74 6f 20 46 49 4c 45 0a 2e 62  ain") to FILE..b
10b0: 61 69 6c 20 4f 4e 7c 4f 46 46 20 20 20 20 20 20  ail ON|OFF      
10c0: 20 20 20 20 20 53 74 6f 70 20 61 66 74 65 72 20       Stop after 
10d0: 68 69 74 74 69 6e 67 20 61 6e 20 65 72 72 6f 72  hitting an error
10e0: 2e 20 20 44 65 66 61 75 6c 74 20 4f 46 46 0a 2e  .  Default OFF..
10f0: 64 61 74 61 62 61 73 65 73 20 20 20 20 20 20 20  databases       
1100: 20 20 20 20 20 20 4c 69 73 74 20 6e 61 6d 65 73        List names
1110: 20 61 6e 64 20 66 69 6c 65 73 20 6f 66 20 61 74   and files of at
1120: 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73  tached databases
1130: 0a 2e 64 75 6d 70 20 3f 54 41 42 4c 45 3f 20 2e  ..dump ?TABLE? .
1140: 2e 2e 20 20 20 20 20 20 44 75 6d 70 20 74 68 65  ..      Dump the
1150: 20 64 61 74 61 62 61 73 65 20 69 6e 20 61 6e 20   database in an 
1160: 53 51 4c 20 74 65 78 74 20 66 6f 72 6d 61 74 0a  SQL text format.
1170: 2e 65 63 68 6f 20 4f 4e 7c 4f 46 46 20 20 20 20  .echo ON|OFF    
1180: 20 20 20 20 20 20 20 54 75 72 6e 20 63 6f 6d 6d         Turn comm
1190: 61 6e 64 20 65 63 68 6f 20 6f 6e 20 6f 72 20 6f  and echo on or o
11a0: 66 66 0a 2e 65 78 69 74 20 20 20 20 20 20 20 20  ff..exit        
11b0: 20 20 20 20 20 20 20 20 20 20 45 78 69 74 20 74            Exit t
11c0: 68 69 73 20 70 72 6f 67 72 61 6d 0a 2e 65 78 70  his program..exp
11d0: 6c 61 69 6e 20 4f 4e 7c 4f 46 46 20 20 20 20 20  lain ON|OFF     
11e0: 20 20 20 54 75 72 6e 20 6f 75 74 70 75 74 20 6d     Turn output m
11f0: 6f 64 65 20 73 75 69 74 61 62 6c 65 20 66 6f 72  ode suitable for
1200: 20 45 58 50 4c 41 49 4e 20 6f 6e 20 6f 72 20 6f   EXPLAIN on or o
1210: 66 66 2e 0a 2e 67 65 6e 66 6b 65 79 20 3f 4f 50  ff...genfkey ?OP
1220: 54 49 4f 4e 53 3f 20 20 20 20 20 4f 70 74 69 6f  TIONS?     Optio
1230: 6e 73 20 61 72 65 3a 0a 20 20 20 20 20 20 20 20  ns are:.        
1240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1250: 20 2d 2d 6e 6f 2d 64 72 6f 70 3a 20 44 6f 20 6e   --no-drop: Do n
1260: 6f 74 20 64 72 6f 70 20 6f 6c 64 20 66 6b 65 79  ot drop old fkey
1270: 20 74 72 69 67 67 65 72 73 2e 0a 20 20 20 20 20   triggers..     
1280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1290: 20 20 20 20 2d 2d 69 67 6e 6f 72 65 2d 65 72 72      --ignore-err
12a0: 6f 72 73 3a 20 49 67 6e 6f 72 65 20 74 61 62 6c  ors: Ignore tabl
12b0: 65 73 20 77 69 74 68 20 66 6b 65 79 20 65 72 72  es with fkey err
12c0: 6f 72 73 0a 20 20 20 20 20 20 20 20 20 20 20 20  ors.            
12d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 65               --e
12e0: 78 65 63 3a 20 45 78 65 63 75 74 65 20 67 65 6e  xec: Execute gen
12f0: 65 72 61 74 65 64 20 53 51 4c 20 69 6d 6d 65 64  erated SQL immed
1300: 69 61 74 65 6c 79 0a 20 20 20 20 20 20 20 20 20  iately.         
1310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65                Se
1320: 65 20 66 69 6c 65 20 74 6f 6f 6c 2f 67 65 6e 66  e file tool/genf
1330: 6b 65 79 2e 52 45 41 44 4d 45 20 69 6e 20 74 68  key.README in th
1340: 65 20 73 6f 75 72 63 65 20 0a 20 20 20 20 20 20  e source .      
1350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1360: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 66 6f   distribution fo
1370: 72 20 66 75 72 74 68 65 72 20 69 6e 66 6f 72 6d  r further inform
1380: 61 74 69 6f 6e 2e 0a 2e 68 65 61 64 65 72 28 73  ation...header(s
1390: 29 20 4f 4e 7c 4f 46 46 20 20 20 20 20 20 54 75  ) ON|OFF      Tu
13a0: 72 6e 20 64 69 73 70 6c 61 79 20 6f 66 20 68 65  rn display of he
13b0: 61 64 65 72 73 20 6f 6e 20 6f 72 20 6f 66 66 0a  aders on or off.
13c0: 2e 68 65 6c 70 20 20 20 20 20 20 20 20 20 20 20  .help           
13d0: 20 20 20 20 20 20 20 53 68 6f 77 20 74 68 69 73         Show this
13e0: 20 6d 65 73 73 61 67 65 0a 2e 69 6d 70 6f 72 74   message..import
13f0: 20 46 49 4c 45 20 54 41 42 4c 45 20 20 20 20 20   FILE TABLE     
1400: 49 6d 70 6f 72 74 20 64 61 74 61 20 66 72 6f 6d  Import data from
1410: 20 46 49 4c 45 20 69 6e 74 6f 20 54 41 42 4c 45   FILE into TABLE
1420: 0a 2e 69 6e 64 69 63 65 73 20 54 41 42 4c 45 20  ..indices TABLE 
1430: 20 20 20 20 20 20 20 20 53 68 6f 77 20 6e 61 6d          Show nam
1440: 65 73 20 6f 66 20 61 6c 6c 20 69 6e 64 69 63 65  es of all indice
1450: 73 20 6f 6e 20 54 41 42 4c 45 0a 2e 69 6f 74 72  s on TABLE..iotr
1460: 61 63 65 20 46 49 4c 45 20 20 20 20 20 20 20 20  ace FILE        
1470: 20 20 45 6e 61 62 6c 65 20 49 2f 4f 20 64 69 61    Enable I/O dia
1480: 67 6e 6f 73 74 69 63 20 6c 6f 67 67 69 6e 67 20  gnostic logging 
1490: 74 6f 20 46 49 4c 45 0a 2e 6c 6f 61 64 20 46 49  to FILE..load FI
14a0: 4c 45 20 3f 45 4e 54 52 59 3f 20 20 20 20 20 4c  LE ?ENTRY?     L
14b0: 6f 61 64 20 61 6e 20 65 78 74 65 6e 73 69 6f 6e  oad an extension
14c0: 20 6c 69 62 72 61 72 79 0a 2e 6d 6f 64 65 20 4d   library..mode M
14d0: 4f 44 45 20 3f 54 41 42 4c 45 3f 20 20 20 20 20  ODE ?TABLE?     
14e0: 53 65 74 20 6f 75 74 70 75 74 20 6d 6f 64 65 20  Set output mode 
14f0: 77 68 65 72 65 20 4d 4f 44 45 20 69 73 20 6f 6e  where MODE is on
1500: 65 20 6f 66 3a 0a 20 20 20 20 20 20 20 20 20 20  e of:.          
1510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63                 c
1520: 73 76 20 20 20 20 20 20 43 6f 6d 6d 61 2d 73 65  sv      Comma-se
1530: 70 61 72 61 74 65 64 20 76 61 6c 75 65 73 0a 20  parated values. 
1540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1550: 20 20 20 20 20 20 20 20 63 6f 6c 75 6d 6e 20 20          column  
1560: 20 4c 65 66 74 2d 61 6c 69 67 6e 65 64 20 63 6f   Left-aligned co
1570: 6c 75 6d 6e 73 2e 20 20 28 53 65 65 20 2e 77 69  lumns.  (See .wi
1580: 64 74 68 29 0a 20 20 20 20 20 20 20 20 20 20 20  dth).           
1590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 68 74                ht
15a0: 6d 6c 20 20 20 20 20 48 54 4d 4c 20 3c 74 61 62  ml     HTML <tab
15b0: 6c 65 3e 20 63 6f 64 65 0a 20 20 20 20 20 20 20  le> code.       
15c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
15d0: 20 20 69 6e 73 65 72 74 20 20 20 53 51 4c 20 69    insert   SQL i
15e0: 6e 73 65 72 74 20 73 74 61 74 65 6d 65 6e 74 73  nsert statements
15f0: 20 66 6f 72 20 54 41 42 4c 45 0a 20 20 20 20 20   for TABLE.     
1600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1610: 20 20 20 20 6c 69 6e 65 20 20 20 20 20 4f 6e 65      line     One
1620: 20 76 61 6c 75 65 20 70 65 72 20 6c 69 6e 65 0a   value per line.
1630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1640: 20 20 20 20 20 20 20 20 20 6c 69 73 74 20 20 20           list   
1650: 20 20 56 61 6c 75 65 73 20 64 65 6c 69 6d 69 74    Values delimit
1660: 65 64 20 62 79 20 2e 73 65 70 61 72 61 74 6f 72  ed by .separator
1670: 20 73 74 72 69 6e 67 0a 20 20 20 20 20 20 20 20   string.        
1680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1690: 20 74 61 62 73 20 20 20 20 20 54 61 62 2d 73 65   tabs     Tab-se
16a0: 70 61 72 61 74 65 64 20 76 61 6c 75 65 73 0a 20  parated values. 
16b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
16c0: 20 20 20 20 20 20 20 20 74 63 6c 20 20 20 20 20          tcl     
16d0: 20 54 43 4c 20 6c 69 73 74 20 65 6c 65 6d 65 6e   TCL list elemen
16e0: 74 73 0a 2e 6e 75 6c 6c 76 61 6c 75 65 20 53 54  ts..nullvalue ST
16f0: 52 49 4e 47 20 20 20 20 20 20 50 72 69 6e 74 20  RING      Print 
1700: 53 54 52 49 4e 47 20 69 6e 20 70 6c 61 63 65 20  STRING in place 
1710: 6f 66 20 4e 55 4c 4c 20 76 61 6c 75 65 73 0a 2e  of NULL values..
1720: 6f 75 74 70 75 74 20 46 49 4c 45 4e 41 4d 45 20  output FILENAME 
1730: 20 20 20 20 20 20 53 65 6e 64 20 6f 75 74 70 75        Send outpu
1740: 74 20 74 6f 20 46 49 4c 45 4e 41 4d 45 0a 2e 6f  t to FILENAME..o
1750: 75 74 70 75 74 20 73 74 64 6f 75 74 20 20 20 20  utput stdout    
1760: 20 20 20 20 20 53 65 6e 64 20 6f 75 74 70 75 74       Send output
1770: 20 74 6f 20 74 68 65 20 73 63 72 65 65 6e 0a 2e   to the screen..
1780: 70 72 6f 6d 70 74 20 4d 41 49 4e 20 43 4f 4e 54  prompt MAIN CONT
1790: 49 4e 55 45 20 20 52 65 70 6c 61 63 65 20 74 68  INUE  Replace th
17a0: 65 20 73 74 61 6e 64 61 72 64 20 70 72 6f 6d 70  e standard promp
17b0: 74 73 0a 2e 71 75 69 74 20 20 20 20 20 20 20 20  ts..quit        
17c0: 20 20 20 20 20 20 20 20 20 20 45 78 69 74 20 74            Exit t
17d0: 68 69 73 20 70 72 6f 67 72 61 6d 0a 2e 72 65 61  his program..rea
17e0: 64 20 46 49 4c 45 4e 41 4d 45 20 20 20 20 20 20  d FILENAME      
17f0: 20 20 20 45 78 65 63 75 74 65 20 53 51 4c 20 69     Execute SQL i
1800: 6e 20 46 49 4c 45 4e 41 4d 45 0a 2e 72 65 73 74  n FILENAME..rest
1810: 6f 72 65 20 3f 44 42 3f 20 46 49 4c 45 20 20 20  ore ?DB? FILE   
1820: 20 20 52 65 73 74 6f 72 65 20 63 6f 6e 74 65 6e    Restore conten
1830: 74 20 6f 66 20 44 42 20 28 64 65 66 61 75 6c 74  t of DB (default
1840: 20 22 6d 61 69 6e 22 29 20 66 72 6f 6d 20 46 49   "main") from FI
1850: 4c 45 0a 2e 73 63 68 65 6d 61 20 3f 54 41 42 4c  LE..schema ?TABL
1860: 45 3f 20 20 20 20 20 20 20 20 53 68 6f 77 20 74  E?        Show t
1870: 68 65 20 43 52 45 41 54 45 20 73 74 61 74 65 6d  he CREATE statem
1880: 65 6e 74 73 0a 2e 73 65 70 61 72 61 74 6f 72 20  ents..separator 
1890: 53 54 52 49 4e 47 20 20 20 20 20 20 43 68 61 6e  STRING      Chan
18a0: 67 65 20 73 65 70 61 72 61 74 6f 72 20 75 73 65  ge separator use
18b0: 64 20 62 79 20 6f 75 74 70 75 74 20 6d 6f 64 65  d by output mode
18c0: 20 61 6e 64 20 2e 69 6d 70 6f 72 74 0a 2e 73 68   and .import..sh
18d0: 6f 77 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ow              
18e0: 20 20 20 20 53 68 6f 77 20 74 68 65 20 63 75 72      Show the cur
18f0: 72 65 6e 74 20 76 61 6c 75 65 73 20 66 6f 72 20  rent values for 
1900: 76 61 72 69 6f 75 73 20 73 65 74 74 69 6e 67 73  various settings
1910: 0a 2e 74 61 62 6c 65 73 20 3f 50 41 54 54 45 52  ..tables ?PATTER
1920: 4e 3f 20 20 20 20 20 20 4c 69 73 74 20 6e 61 6d  N?      List nam
1930: 65 73 20 6f 66 20 74 61 62 6c 65 73 20 6d 61 74  es of tables mat
1940: 63 68 69 6e 67 20 61 20 4c 49 4b 45 20 70 61 74  ching a LIKE pat
1950: 74 65 72 6e 0a 2e 74 69 6d 65 6f 75 74 20 4d 53  tern..timeout MS
1960: 20 20 20 20 20 20 20 20 20 20 20 20 54 72 79 20              Try 
1970: 6f 70 65 6e 69 6e 67 20 6c 6f 63 6b 65 64 20 74  opening locked t
1980: 61 62 6c 65 73 20 66 6f 72 20 4d 53 20 6d 69 6c  ables for MS mil
1990: 6c 69 73 65 63 6f 6e 64 73 0a 2e 74 69 6d 65 72  liseconds..timer
19a0: 20 4f 4e 7c 4f 46 46 20 20 20 20 20 20 20 20 20   ON|OFF         
19b0: 20 54 75 72 6e 20 74 68 65 20 43 50 55 20 74 69   Turn the CPU ti
19c0: 6d 65 72 20 6d 65 61 73 75 72 65 6d 65 6e 74 20  mer measurement 
19d0: 6f 6e 20 6f 72 20 6f 66 66 0a 2e 77 69 64 74 68  on or off..width
19e0: 20 4e 55 4d 20 4e 55 4d 20 2e 2e 2e 20 20 20 20   NUM NUM ...    
19f0: 20 53 65 74 20 63 6f 6c 75 6d 6e 20 77 69 64 74   Set column widt
1a00: 68 73 20 66 6f 72 20 22 63 6f 6c 75 6d 6e 22 20  hs for "column" 
1a10: 6d 6f 64 65 0a 73 71 6c 69 74 65 3e 20 0a 7d 3c  mode.sqlite> .}<
1a20: 2f 74 63 6c 3e 0a 0a 3c 68 33 3e 43 68 61 6e 67  /tcl>..<h3>Chang
1a30: 69 6e 67 20 4f 75 74 70 75 74 20 46 6f 72 6d 61  ing Output Forma
1a40: 74 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 20  ts</h3>..<p>The 
1a50: 73 71 6c 69 74 65 33 20 70 72 6f 67 72 61 6d 20  sqlite3 program 
1a60: 69 73 20 61 62 6c 65 20 74 6f 20 73 68 6f 77 20  is able to show 
1a70: 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 61  the results of a
1a80: 20 71 75 65 72 79 0a 69 6e 20 65 69 67 68 74 20   query.in eight 
1a90: 64 69 66 66 65 72 65 6e 74 20 66 6f 72 6d 61 74  different format
1aa0: 73 3a 20 22 63 73 76 22 2c 20 22 63 6f 6c 75 6d  s: "csv", "colum
1ab0: 6e 22 2c 20 22 68 74 6d 6c 22 2c 20 22 69 6e 73  n", "html", "ins
1ac0: 65 72 74 22 2c 0a 22 6c 69 6e 65 22 2c 20 22 6c  ert",."line", "l
1ad0: 69 73 74 22 2c 20 22 74 61 62 73 22 2c 20 61 6e  ist", "tabs", an
1ae0: 64 20 22 74 63 6c 22 2e 0a 59 6f 75 20 63 61 6e  d "tcl"..You can
1af0: 20 75 73 65 20 74 68 65 20 22 2e 6d 6f 64 65 22   use the ".mode"
1b00: 20 64 6f 74 20 63 6f 6d 6d 61 6e 64 20 74 6f 20   dot command to 
1b10: 73 77 69 74 63 68 20 62 65 74 77 65 65 6e 20 74  switch between t
1b20: 68 65 73 65 20 6f 75 74 70 75 74 0a 66 6f 72 6d  hese output.form
1b30: 61 74 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ats.</p>..<p>The
1b40: 20 64 65 66 61 75 6c 74 20 6f 75 74 70 75 74 20   default output 
1b50: 6d 6f 64 65 20 69 73 20 22 6c 69 73 74 22 2e 20  mode is "list". 
1b60: 20 49 6e 0a 6c 69 73 74 20 6d 6f 64 65 2c 20 65   In.list mode, e
1b70: 61 63 68 20 72 65 63 6f 72 64 20 6f 66 20 61 20  ach record of a 
1b80: 71 75 65 72 79 20 72 65 73 75 6c 74 20 69 73 20  query result is 
1b90: 77 72 69 74 74 65 6e 20 6f 6e 20 6f 6e 65 20 6c  written on one l
1ba0: 69 6e 65 20 6f 66 0a 6f 75 74 70 75 74 20 61 6e  ine of.output an
1bb0: 64 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 77 69  d each column wi
1bc0: 74 68 69 6e 20 74 68 61 74 20 72 65 63 6f 72 64  thin that record
1bd0: 20 69 73 20 73 65 70 61 72 61 74 65 64 20 62 79   is separated by
1be0: 20 61 20 73 70 65 63 69 66 69 63 0a 73 65 70 61   a specific.sepa
1bf0: 72 61 74 6f 72 20 73 74 72 69 6e 67 2e 20 20 54  rator string.  T
1c00: 68 65 20 64 65 66 61 75 6c 74 20 73 65 70 61 72  he default separ
1c10: 61 74 6f 72 20 69 73 20 61 20 70 69 70 65 20 73  ator is a pipe s
1c20: 79 6d 62 6f 6c 20 28 22 7c 22 29 2e 0a 4c 69 73  ymbol ("|")..Lis
1c30: 74 20 6d 6f 64 65 20 69 73 20 65 73 70 65 63 69  t mode is especi
1c40: 61 6c 6c 79 20 75 73 65 66 75 6c 20 77 68 65 6e  ally useful when
1c50: 20 79 6f 75 20 61 72 65 20 67 6f 69 6e 67 20 74   you are going t
1c60: 6f 20 73 65 6e 64 20 74 68 65 20 6f 75 74 70 75  o send the outpu
1c70: 74 0a 6f 66 20 61 20 71 75 65 72 79 20 74 6f 20  t.of a query to 
1c80: 61 6e 6f 74 68 65 72 20 70 72 6f 67 72 61 6d 20  another program 
1c90: 28 73 75 63 68 20 61 73 20 41 57 4b 29 20 66 6f  (such as AWK) fo
1ca0: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 70 72 6f  r additional pro
1cb0: 63 65 73 73 69 6e 67 2e 3c 2f 70 3e 0a 0a 3c 74  cessing.</p>..<t
1cc0: 63 6c 3e 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65  cl>Code {.sqlite
1cd0: 3e 20 28 28 28 2e 6d 6f 64 65 20 6c 69 73 74 29  > (((.mode list)
1ce0: 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 73 65  )).sqlite> (((se
1cf0: 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62 6c 31  lect * from tbl1
1d00: 3b 29 29 29 0a 68 65 6c 6c 6f 7c 31 30 0a 67 6f  ;))).hello|10.go
1d10: 6f 64 62 79 65 7c 32 30 0a 73 71 6c 69 74 65 3e  odbye|20.sqlite>
1d20: 0a 7d 3c 2f 74 63 6c 3e 0a 0a 3c 70 3e 59 6f 75  .}</tcl>..<p>You
1d30: 20 63 61 6e 20 75 73 65 20 74 68 65 20 22 2e 73   can use the ".s
1d40: 65 70 61 72 61 74 6f 72 22 20 64 6f 74 20 63 6f  eparator" dot co
1d50: 6d 6d 61 6e 64 20 74 6f 20 63 68 61 6e 67 65 20  mmand to change 
1d60: 74 68 65 20 73 65 70 61 72 61 74 6f 72 0a 66 6f  the separator.fo
1d70: 72 20 6c 69 73 74 20 6d 6f 64 65 2e 20 20 46 6f  r list mode.  Fo
1d80: 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 63 68  r example, to ch
1d90: 61 6e 67 65 20 74 68 65 20 73 65 70 61 72 61 74  ange the separat
1da0: 6f 72 20 74 6f 20 61 20 63 6f 6d 6d 61 20 61 6e  or to a comma an
1db0: 64 0a 61 20 73 70 61 63 65 2c 20 79 6f 75 20 63  d.a space, you c
1dc0: 6f 75 6c 64 20 64 6f 20 74 68 69 73 3a 3c 2f 70  ould do this:</p
1dd0: 3e 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a 73  >..<tcl>Code {.s
1de0: 71 6c 69 74 65 3e 20 28 28 28 2e 73 65 70 61 72  qlite> (((.separ
1df0: 61 74 6f 72 20 22 2c 20 22 29 29 29 0a 73 71 6c  ator ", "))).sql
1e00: 69 74 65 3e 20 28 28 28 73 65 6c 65 63 74 20 2a  ite> (((select *
1e10: 20 66 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a 68   from tbl1;))).h
1e20: 65 6c 6c 6f 2c 20 31 30 0a 67 6f 6f 64 62 79 65  ello, 10.goodbye
1e30: 2c 20 32 30 0a 73 71 6c 69 74 65 3e 0a 7d 3c 2f  , 20.sqlite>.}</
1e40: 74 63 6c 3e 0a 0a 3c 70 3e 49 6e 20 22 6c 69 6e  tcl>..<p>In "lin
1e50: 65 22 20 6d 6f 64 65 2c 20 65 61 63 68 20 63 6f  e" mode, each co
1e60: 6c 75 6d 6e 20 69 6e 20 61 20 72 6f 77 20 6f 66  lumn in a row of
1e70: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 69 73   the database.is
1e80: 20 73 68 6f 77 6e 20 6f 6e 20 61 20 6c 69 6e 65   shown on a line
1e90: 20 62 79 20 69 74 73 65 6c 66 2e 20 20 45 61 63   by itself.  Eac
1ea0: 68 20 6c 69 6e 65 20 63 6f 6e 73 69 73 74 73 20  h line consists 
1eb0: 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 6e 61  of the column.na
1ec0: 6d 65 2c 20 61 6e 20 65 71 75 61 6c 20 73 69 67  me, an equal sig
1ed0: 6e 20 61 6e 64 20 74 68 65 20 63 6f 6c 75 6d 6e  n and the column
1ee0: 20 64 61 74 61 2e 20 20 53 75 63 63 65 73 73 69   data.  Successi
1ef0: 76 65 20 72 65 63 6f 72 64 73 20 61 72 65 0a 73  ve records are.s
1f00: 65 70 61 72 61 74 65 64 20 62 79 20 61 20 62 6c  eparated by a bl
1f10: 61 6e 6b 20 6c 69 6e 65 2e 20 20 48 65 72 65 20  ank line.  Here 
1f20: 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 6f 66  is an example of
1f30: 20 6c 69 6e 65 20 6d 6f 64 65 0a 6f 75 74 70 75   line mode.outpu
1f40: 74 3a 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 43 6f 64  t:</p>..<tcl>Cod
1f50: 65 20 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e  e {.sqlite> (((.
1f60: 6d 6f 64 65 20 6c 69 6e 65 29 29 29 0a 73 71 6c  mode line))).sql
1f70: 69 74 65 3e 20 28 28 28 73 65 6c 65 63 74 20 2a  ite> (((select *
1f80: 20 66 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a 6f   from tbl1;))).o
1f90: 6e 65 20 3d 20 68 65 6c 6c 6f 0a 74 77 6f 20 3d  ne = hello.two =
1fa0: 20 31 30 0a 0a 6f 6e 65 20 3d 20 67 6f 6f 64 62   10..one = goodb
1fb0: 79 65 0a 74 77 6f 20 3d 20 32 30 0a 73 71 6c 69  ye.two = 20.sqli
1fc0: 74 65 3e 0a 7d 3c 2f 74 63 6c 3e 0a 0a 3c 70 3e  te>.}</tcl>..<p>
1fd0: 49 6e 20 63 6f 6c 75 6d 6e 20 6d 6f 64 65 2c 20  In column mode, 
1fe0: 65 61 63 68 20 72 65 63 6f 72 64 20 69 73 20 73  each record is s
1ff0: 68 6f 77 6e 20 6f 6e 20 61 20 73 65 70 61 72 61  hown on a separa
2000: 74 65 20 6c 69 6e 65 20 77 69 74 68 20 74 68 65  te line with the
2010: 0a 64 61 74 61 20 61 6c 69 67 6e 65 64 20 69 6e  .data aligned in
2020: 20 63 6f 6c 75 6d 6e 73 2e 20 20 46 6f 72 20 65   columns.  For e
2030: 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 3c 74 63  xample:</p>..<tc
2040: 6c 3e 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65 3e  l>Code {.sqlite>
2050: 20 28 28 28 2e 6d 6f 64 65 20 63 6f 6c 75 6d 6e   (((.mode column
2060: 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 73  ))).sqlite> (((s
2070: 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62 6c  elect * from tbl
2080: 31 3b 29 29 29 0a 6f 6e 65 20 20 20 20 20 20 20  1;))).one       
2090: 20 20 74 77 6f 20 20 20 20 20 20 20 0a 2d 2d 2d    two       .---
20a0: 2d 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d 2d 2d 2d  -------  -------
20b0: 2d 2d 2d 0a 68 65 6c 6c 6f 20 20 20 20 20 20 20  ---.hello       
20c0: 31 30 20 20 20 20 20 20 20 20 0a 67 6f 6f 64 62  10        .goodb
20d0: 79 65 20 20 20 20 20 32 30 20 20 20 20 20 20 20  ye     20       
20e0: 20 0a 73 71 6c 69 74 65 3e 0a 7d 3c 2f 74 63 6c   .sqlite>.}</tcl
20f0: 3e 0a 0a 3c 70 3e 42 79 20 64 65 66 61 75 6c 74  >..<p>By default
2100: 2c 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 69 73  , each column is
2110: 20 61 74 20 6c 65 61 73 74 20 31 30 20 63 68 61   at least 10 cha
2120: 72 61 63 74 65 72 73 20 77 69 64 65 2e 20 0a 44  racters wide. .D
2130: 61 74 61 20 74 68 61 74 20 69 73 20 74 6f 6f 20  ata that is too 
2140: 77 69 64 65 20 74 6f 20 66 69 74 20 69 6e 20 61  wide to fit in a
2150: 20 63 6f 6c 75 6d 6e 20 69 73 20 74 72 75 6e 63   column is trunc
2160: 61 74 65 64 2e 20 20 59 6f 75 20 63 61 6e 0a 61  ated.  You can.a
2170: 64 6a 75 73 74 20 74 68 65 20 63 6f 6c 75 6d 6e  djust the column
2180: 20 77 69 64 74 68 73 20 75 73 69 6e 67 20 74 68   widths using th
2190: 65 20 22 2e 77 69 64 74 68 22 20 63 6f 6d 6d 61  e ".width" comma
21a0: 6e 64 2e 20 20 4c 69 6b 65 20 74 68 69 73 3a 3c  nd.  Like this:<
21b0: 2f 70 3e 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b  /p>..<tcl>Code {
21c0: 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 77 69 64  .sqlite> (((.wid
21d0: 74 68 20 31 32 20 36 29 29 29 0a 73 71 6c 69 74  th 12 6))).sqlit
21e0: 65 3e 20 28 28 28 73 65 6c 65 63 74 20 2a 20 66  e> (((select * f
21f0: 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a 6f 6e 65  rom tbl1;))).one
2200: 20 20 20 20 20 20 20 20 20 20 20 74 77 6f 20 20             two  
2210: 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20   .------------  
2220: 2d 2d 2d 2d 2d 2d 0a 68 65 6c 6c 6f 20 20 20 20  ------.hello    
2230: 20 20 20 20 20 31 30 20 20 20 20 0a 67 6f 6f 64       10    .good
2240: 62 79 65 20 20 20 20 20 20 20 32 30 20 20 20 20  bye       20    
2250: 0a 73 71 6c 69 74 65 3e 0a 7d 3c 2f 74 63 6c 3e  .sqlite>.}</tcl>
2260: 0a 0a 3c 70 3e 54 68 65 20 22 2e 77 69 64 74 68  ..<p>The ".width
2270: 22 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 74 68 65  " command in the
2280: 20 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 20 73   example above s
2290: 65 74 73 20 74 68 65 20 77 69 64 74 68 20 6f 66  ets the width of
22a0: 20 74 68 65 20 66 69 72 73 74 0a 63 6f 6c 75 6d   the first.colum
22b0: 6e 20 74 6f 20 31 32 20 61 6e 64 20 74 68 65 20  n to 12 and the 
22c0: 77 69 64 74 68 20 6f 66 20 74 68 65 20 73 65 63  width of the sec
22d0: 6f 6e 64 20 63 6f 6c 75 6d 6e 20 74 6f 20 36 2e  ond column to 6.
22e0: 20 20 41 6c 6c 20 6f 74 68 65 72 20 63 6f 6c 75    All other colu
22f0: 6d 6e 0a 77 69 64 74 68 73 20 77 65 72 65 20 75  mn.widths were u
2300: 6e 61 6c 74 65 72 65 64 2e 20 20 59 6f 75 20 63  naltered.  You c
2310: 61 6e 20 67 69 76 65 73 20 61 73 20 6d 61 6e 79  an gives as many
2320: 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 22 2e   arguments to ".
2330: 77 69 64 74 68 22 20 61 73 0a 6e 65 63 65 73 73  width" as.necess
2340: 61 72 79 20 74 6f 20 73 70 65 63 69 66 79 20 74  ary to specify t
2350: 68 65 20 77 69 64 74 68 73 20 6f 66 20 61 73 20  he widths of as 
2360: 6d 61 6e 79 20 63 6f 6c 75 6d 6e 73 20 61 73 20  many columns as 
2370: 61 72 65 20 69 6e 20 79 6f 75 72 0a 71 75 65 72  are in your.quer
2380: 79 20 72 65 73 75 6c 74 73 2e 3c 2f 70 3e 0a 0a  y results.</p>..
2390: 3c 70 3e 49 66 20 79 6f 75 20 73 70 65 63 69 66  <p>If you specif
23a0: 79 20 61 20 63 6f 6c 75 6d 6e 20 61 20 77 69 64  y a column a wid
23b0: 74 68 20 6f 66 20 30 2c 20 74 68 65 6e 20 74 68  th of 0, then th
23c0: 65 20 63 6f 6c 75 6d 6e 0a 77 69 64 74 68 20 69  e column.width i
23d0: 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  s automatically 
23e0: 61 64 6a 75 73 74 65 64 20 74 6f 20 62 65 20 74  adjusted to be t
23f0: 68 65 20 6d 61 78 69 6d 75 6d 20 6f 66 20 74 68  he maximum of th
2400: 72 65 65 0a 6e 75 6d 62 65 72 73 3a 20 31 30 2c  ree.numbers: 10,
2410: 20 74 68 65 20 77 69 64 74 68 20 6f 66 20 74 68   the width of th
2420: 65 20 68 65 61 64 65 72 2c 20 61 6e 64 20 74 68  e header, and th
2430: 65 20 77 69 64 74 68 20 6f 66 20 74 68 65 0a 66  e width of the.f
2440: 69 72 73 74 20 72 6f 77 20 6f 66 20 64 61 74 61  irst row of data
2450: 2e 20 20 54 68 69 73 20 6d 61 6b 65 73 20 74 68  .  This makes th
2460: 65 20 63 6f 6c 75 6d 6e 20 77 69 64 74 68 20 73  e column width s
2470: 65 6c 66 2d 61 64 6a 75 73 74 69 6e 67 2e 0a 54  elf-adjusting..T
2480: 68 65 20 64 65 66 61 75 6c 74 20 77 69 64 74 68  he default width
2490: 20 73 65 74 74 69 6e 67 20 66 6f 72 20 65 76 65   setting for eve
24a0: 72 79 20 63 6f 6c 75 6d 6e 20 69 73 20 74 68 69  ry column is thi
24b0: 73 20 0a 61 75 74 6f 2d 61 64 6a 75 73 74 69 6e  s .auto-adjustin
24c0: 67 20 30 20 76 61 6c 75 65 2e 3c 2f 70 3e 0a 0a  g 0 value.</p>..
24d0: 3c 70 3e 54 68 65 20 63 6f 6c 75 6d 6e 20 6c 61  <p>The column la
24e0: 62 65 6c 73 20 74 68 61 74 20 61 70 70 65 61 72  bels that appear
24f0: 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 74 77   on the first tw
2500: 6f 20 6c 69 6e 65 73 20 6f 66 20 6f 75 74 70 75  o lines of outpu
2510: 74 0a 63 61 6e 20 62 65 20 74 75 72 6e 65 64 20  t.can be turned 
2520: 6f 6e 20 61 6e 64 20 6f 66 66 20 75 73 69 6e 67  on and off using
2530: 20 74 68 65 20 22 2e 68 65 61 64 65 72 22 20 64   the ".header" d
2540: 6f 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 49 6e 20  ot command.  In 
2550: 74 68 65 0a 65 78 61 6d 70 6c 65 73 20 61 62 6f  the.examples abo
2560: 76 65 2c 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6c  ve, the column l
2570: 61 62 65 6c 73 20 61 72 65 20 6f 6e 2e 20 20 54  abels are on.  T
2580: 6f 20 74 75 72 6e 20 74 68 65 6d 20 6f 66 66 20  o turn them off 
2590: 79 6f 75 0a 63 6f 75 6c 64 20 64 6f 20 74 68 69  you.could do thi
25a0: 73 3a 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 43 6f 64  s:</p>..<tcl>Cod
25b0: 65 20 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e  e {.sqlite> (((.
25c0: 68 65 61 64 65 72 20 6f 66 66 29 29 29 0a 73 71  header off))).sq
25d0: 6c 69 74 65 3e 20 28 28 28 73 65 6c 65 63 74 20  lite> (((select 
25e0: 2a 20 66 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a  * from tbl1;))).
25f0: 68 65 6c 6c 6f 20 20 20 20 20 20 20 20 20 31 30  hello         10
2600: 20 20 20 20 0a 67 6f 6f 64 62 79 65 20 20 20 20      .goodbye    
2610: 20 20 20 32 30 20 20 20 20 0a 73 71 6c 69 74 65     20    .sqlite
2620: 3e 0a 7d 3c 2f 74 63 6c 3e 0a 0a 3c 70 3e 41 6e  >.}</tcl>..<p>An
2630: 6f 74 68 65 72 20 75 73 65 66 75 6c 20 6f 75 74  other useful out
2640: 70 75 74 20 6d 6f 64 65 20 69 73 20 22 69 6e 73  put mode is "ins
2650: 65 72 74 22 2e 20 20 49 6e 20 69 6e 73 65 72 74  ert".  In insert
2660: 20 6d 6f 64 65 2c 20 74 68 65 20 6f 75 74 70 75   mode, the outpu
2670: 74 0a 69 73 20 66 6f 72 6d 61 74 74 65 64 20 74  t.is formatted t
2680: 6f 20 6c 6f 6f 6b 20 6c 69 6b 65 20 53 51 4c 20  o look like SQL 
2690: 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74  INSERT statement
26a0: 73 2e 20 20 59 6f 75 20 63 61 6e 20 75 73 65 20  s.  You can use 
26b0: 69 6e 73 65 72 74 0a 6d 6f 64 65 20 74 6f 20 67  insert.mode to g
26c0: 65 6e 65 72 61 74 65 20 74 65 78 74 20 74 68 61  enerate text tha
26d0: 74 20 63 61 6e 20 6c 61 74 65 72 20 62 65 20 75  t can later be u
26e0: 73 65 64 20 74 6f 20 69 6e 70 75 74 20 64 61 74  sed to input dat
26f0: 61 20 69 6e 74 6f 20 61 20 0a 64 69 66 66 65 72  a into a .differ
2700: 65 6e 74 20 64 61 74 61 62 61 73 65 2e 3c 2f 70  ent database.</p
2710: 3e 0a 0a 3c 70 3e 57 68 65 6e 20 73 70 65 63 69  >..<p>When speci
2720: 66 79 69 6e 67 20 69 6e 73 65 72 74 20 6d 6f 64  fying insert mod
2730: 65 2c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 67  e, you have to g
2740: 69 76 65 20 61 6e 20 65 78 74 72 61 20 61 72 67  ive an extra arg
2750: 75 6d 65 6e 74 0a 77 68 69 63 68 20 69 73 20 74  ument.which is t
2760: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74  he name of the t
2770: 61 62 6c 65 20 74 6f 20 62 65 20 69 6e 73 65 72  able to be inser
2780: 74 65 64 20 69 6e 74 6f 2e 20 20 46 6f 72 20 65  ted into.  For e
2790: 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 3c 74 63  xample:</p>..<tc
27a0: 6c 3e 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65 3e  l>Code {.sqlite>
27b0: 20 28 28 28 2e 6d 6f 64 65 20 69 6e 73 65 72 74   (((.mode insert
27c0: 20 6e 65 77 5f 74 61 62 6c 65 29 29 29 0a 73 71   new_table))).sq
27d0: 6c 69 74 65 3e 20 28 28 28 73 65 6c 65 63 74 20  lite> (((select 
27e0: 2a 20 66 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a  * from tbl1;))).
27f0: 49 4e 53 45 52 54 20 49 4e 54 4f 20 27 6e 65 77  INSERT INTO 'new
2800: 5f 74 61 62 6c 65 27 20 56 41 4c 55 45 53 28 27  _table' VALUES('
2810: 68 65 6c 6c 6f 27 2c 31 30 29 3b 0a 49 4e 53 45  hello',10);.INSE
2820: 52 54 20 49 4e 54 4f 20 27 6e 65 77 5f 74 61 62  RT INTO 'new_tab
2830: 6c 65 27 20 56 41 4c 55 45 53 28 27 67 6f 6f 64  le' VALUES('good
2840: 62 79 65 27 2c 32 30 29 3b 0a 73 71 6c 69 74 65  bye',20);.sqlite
2850: 3e 0a 7d 3c 2f 74 63 6c 3e 0a 0a 0a 3c 70 3e 54  >.}</tcl>...<p>T
2860: 68 65 20 6c 61 73 74 20 6f 75 74 70 75 74 20 6d  he last output m
2870: 6f 64 65 20 69 73 20 22 68 74 6d 6c 22 2e 20 20  ode is "html".  
2880: 49 6e 20 74 68 69 73 20 6d 6f 64 65 2c 20 73 71  In this mode, sq
2890: 6c 69 74 65 33 20 77 72 69 74 65 73 0a 74 68 65  lite3 writes.the
28a0: 20 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20   results of the 
28b0: 71 75 65 72 79 20 61 73 20 61 6e 20 58 48 54 4d  query as an XHTM
28c0: 4c 20 74 61 62 6c 65 2e 20 20 54 68 65 20 62 65  L table.  The be
28d0: 67 69 6e 6e 69 6e 67 0a 26 6c 74 3b 54 41 42 4c  ginning.&lt;TABL
28e0: 45 26 67 74 3b 20 61 6e 64 20 74 68 65 20 65 6e  E&gt; and the en
28f0: 64 69 6e 67 20 26 6c 74 3b 2f 54 41 42 4c 45 26  ding &lt;/TABLE&
2900: 67 74 3b 20 61 72 65 20 6e 6f 74 20 77 72 69 74  gt; are not writ
2910: 74 65 6e 2c 20 62 75 74 0a 61 6c 6c 20 6f 66 20  ten, but.all of 
2920: 74 68 65 20 69 6e 74 65 72 76 65 6e 69 6e 67 20  the intervening 
2930: 26 6c 74 3b 54 52 26 67 74 3b 73 2c 20 26 6c 74  &lt;TR&gt;s, &lt
2940: 3b 54 48 26 67 74 3b 73 2c 20 61 6e 64 20 26 6c  ;TH&gt;s, and &l
2950: 74 3b 54 44 26 67 74 3b 73 0a 61 72 65 2e 20 20  t;TD&gt;s.are.  
2960: 54 68 65 20 68 74 6d 6c 20 6f 75 74 70 75 74 20  The html output 
2970: 6d 6f 64 65 20 69 73 20 65 6e 76 69 73 69 6f 6e  mode is envision
2980: 65 64 20 61 73 20 62 65 69 6e 67 20 75 73 65 66  ed as being usef
2990: 75 6c 20 66 6f 72 0a 43 47 49 2e 3c 2f 70 3e 0a  ul for.CGI.</p>.
29a0: 0a 0a 0a 3c 68 33 3e 57 72 69 74 69 6e 67 20 72  ...<h3>Writing r
29b0: 65 73 75 6c 74 73 20 74 6f 20 61 20 66 69 6c 65  esults to a file
29c0: 3c 2f 68 33 3e 0a 0a 3c 70 3e 42 79 20 64 65 66  </h3>..<p>By def
29d0: 61 75 6c 74 2c 20 73 71 6c 69 74 65 33 20 73 65  ault, sqlite3 se
29e0: 6e 64 73 20 71 75 65 72 79 20 72 65 73 75 6c 74  nds query result
29f0: 73 20 74 6f 20 73 74 61 6e 64 61 72 64 20 6f 75  s to standard ou
2a00: 74 70 75 74 2e 20 20 59 6f 75 0a 63 61 6e 20 63  tput.  You.can c
2a10: 68 61 6e 67 65 20 74 68 69 73 20 75 73 69 6e 67  hange this using
2a20: 20 74 68 65 20 22 2e 6f 75 74 70 75 74 22 20 63   the ".output" c
2a30: 6f 6d 6d 61 6e 64 2e 20 20 4a 75 73 74 20 70 75  ommand.  Just pu
2a40: 74 20 74 68 65 20 6e 61 6d 65 20 6f 66 0a 61 6e  t the name of.an
2a50: 20 6f 75 74 70 75 74 20 66 69 6c 65 20 61 73 20   output file as 
2a60: 61 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74  an argument to t
2a70: 68 65 20 2e 6f 75 74 70 75 74 20 63 6f 6d 6d 61  he .output comma
2a80: 6e 64 20 61 6e 64 20 61 6c 6c 20 73 75 62 73 65  nd and all subse
2a90: 71 75 65 6e 74 0a 71 75 65 72 79 20 72 65 73 75  quent.query resu
2aa0: 6c 74 73 20 77 69 6c 6c 20 62 65 20 77 72 69 74  lts will be writ
2ab0: 74 65 6e 20 74 6f 20 74 68 61 74 20 66 69 6c 65  ten to that file
2ac0: 2e 20 20 55 73 65 20 22 2e 6f 75 74 70 75 74 20  .  Use ".output 
2ad0: 73 74 64 6f 75 74 22 20 74 6f 0a 62 65 67 69 6e  stdout" to.begin
2ae0: 20 77 72 69 74 69 6e 67 20 74 6f 20 73 74 61 6e   writing to stan
2af0: 64 61 72 64 20 6f 75 74 70 75 74 20 61 67 61 69  dard output agai
2b00: 6e 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a  n.  For example:
2b10: 3c 2f 70 3e 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20  </p>..<tcl>Code 
2b20: 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 6d 6f  {.sqlite> (((.mo
2b30: 64 65 20 6c 69 73 74 29 29 29 0a 73 71 6c 69 74  de list))).sqlit
2b40: 65 3e 20 28 28 28 2e 73 65 70 61 72 61 74 6f 72  e> (((.separator
2b50: 20 7c 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28   |))).sqlite> ((
2b60: 28 2e 6f 75 74 70 75 74 20 74 65 73 74 5f 66 69  (.output test_fi
2b70: 6c 65 5f 31 2e 74 78 74 29 29 29 0a 73 71 6c 69  le_1.txt))).sqli
2b80: 74 65 3e 20 28 28 28 73 65 6c 65 63 74 20 2a 20  te> (((select * 
2b90: 66 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a 73 71  from tbl1;))).sq
2ba0: 6c 69 74 65 3e 20 28 28 28 2e 65 78 69 74 29 29  lite> (((.exit))
2bb0: 29 0a 24 20 28 28 28 63 61 74 20 74 65 73 74 5f  ).$ (((cat test_
2bc0: 66 69 6c 65 5f 31 2e 74 78 74 29 29 29 0a 68 65  file_1.txt))).he
2bd0: 6c 6c 6f 7c 31 30 0a 67 6f 6f 64 62 79 65 7c 32  llo|10.goodbye|2
2be0: 30 0a 24 0a 7d 3c 2f 74 63 6c 3e 0a 0a 0a 3c 68  0.$.}</tcl>...<h
2bf0: 33 3e 51 75 65 72 79 69 6e 67 20 74 68 65 20 64  3>Querying the d
2c00: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 3c 2f  atabase schema</
2c10: 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 73 71 6c 69  h3>..<p>The sqli
2c20: 74 65 33 20 70 72 6f 67 72 61 6d 20 70 72 6f 76  te3 program prov
2c30: 69 64 65 73 20 73 65 76 65 72 61 6c 20 63 6f 6e  ides several con
2c40: 76 65 6e 69 65 6e 63 65 20 63 6f 6d 6d 61 6e 64  venience command
2c50: 73 20 74 68 61 74 0a 61 72 65 20 75 73 65 66 75  s that.are usefu
2c60: 6c 20 66 6f 72 20 6c 6f 6f 6b 69 6e 67 20 61 74  l for looking at
2c70: 20 74 68 65 20 73 63 68 65 6d 61 20 6f 66 20 74   the schema of t
2c80: 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 54 68  he database.  Th
2c90: 65 72 65 20 69 73 0a 6e 6f 74 68 69 6e 67 20 74  ere is.nothing t
2ca0: 68 61 74 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e  hat these comman
2cb0: 64 73 20 64 6f 20 74 68 61 74 20 63 61 6e 6e 6f  ds do that canno
2cc0: 74 20 62 65 20 64 6f 6e 65 20 62 79 20 73 6f 6d  t be done by som
2cd0: 65 20 6f 74 68 65 72 0a 6d 65 61 6e 73 2e 20 20  e other.means.  
2ce0: 54 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61  These commands a
2cf0: 72 65 20 70 72 6f 76 69 64 65 64 20 70 75 72 65  re provided pure
2d00: 6c 79 20 61 73 20 61 20 73 68 6f 72 74 63 75 74  ly as a shortcut
2d10: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 72 20 65 78  .</p>..<p>For ex
2d20: 61 6d 70 6c 65 2c 20 74 6f 20 73 65 65 20 61 20  ample, to see a 
2d30: 6c 69 73 74 20 6f 66 20 74 68 65 20 74 61 62 6c  list of the tabl
2d40: 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61  es in the databa
2d50: 73 65 2c 20 79 6f 75 0a 63 61 6e 20 65 6e 74 65  se, you.can ente
2d60: 72 20 22 2e 74 61 62 6c 65 73 22 2e 3c 2f 70 3e  r ".tables".</p>
2d70: 0a 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a 73  ...<tcl>Code {.s
2d80: 71 6c 69 74 65 3e 20 28 28 28 2e 74 61 62 6c 65  qlite> (((.table
2d90: 73 29 29 29 0a 74 62 6c 31 0a 74 62 6c 32 0a 73  s))).tbl1.tbl2.s
2da0: 71 6c 69 74 65 3e 0a 7d 3c 2f 74 63 6c 3e 0a 0a  qlite>.}</tcl>..
2db0: 0a 3c 70 3e 54 68 65 20 22 2e 74 61 62 6c 65 73  .<p>The ".tables
2dc0: 22 20 63 6f 6d 6d 61 6e 64 20 69 73 20 73 69 6d  " command is sim
2dd0: 69 6c 61 72 20 74 6f 20 73 65 74 74 69 6e 67 20  ilar to setting 
2de0: 6c 69 73 74 20 6d 6f 64 65 20 74 68 65 6e 0a 65  list mode then.e
2df0: 78 65 63 75 74 69 6e 67 20 74 68 65 20 66 6f 6c  xecuting the fol
2e00: 6c 6f 77 69 6e 67 20 71 75 65 72 79 3a 3c 2f 70  lowing query:</p
2e10: 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c  >..<blockquote><
2e20: 70 72 65 3e 0a 53 45 4c 45 43 54 20 6e 61 6d 65  pre>.SELECT name
2e30: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73   FROM sqlite_mas
2e40: 74 65 72 20 0a 57 48 45 52 45 20 74 79 70 65 20  ter .WHERE type 
2e50: 49 4e 20 28 27 74 61 62 6c 65 27 2c 27 76 69 65  IN ('table','vie
2e60: 77 27 29 20 41 4e 44 20 6e 61 6d 65 20 4e 4f 54  w') AND name NOT
2e70: 20 4c 49 4b 45 20 27 73 71 6c 69 74 65 5f 25 27   LIKE 'sqlite_%'
2e80: 0a 55 4e 49 4f 4e 20 41 4c 4c 20 0a 53 45 4c 45  .UNION ALL .SELE
2e90: 43 54 20 6e 61 6d 65 20 46 52 4f 4d 20 73 71 6c  CT name FROM sql
2ea0: 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 20  ite_temp_master 
2eb0: 0a 57 48 45 52 45 20 74 79 70 65 20 49 4e 20 28  .WHERE type IN (
2ec0: 27 74 61 62 6c 65 27 2c 27 76 69 65 77 27 29 20  'table','view') 
2ed0: 0a 4f 52 44 45 52 20 42 59 20 31 0a 3c 2f 70 72  .ORDER BY 1.</pr
2ee0: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
2ef0: 0a 3c 70 3e 49 6e 20 66 61 63 74 2c 20 69 66 20  .<p>In fact, if 
2f00: 79 6f 75 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20  you look at the 
2f10: 73 6f 75 72 63 65 20 63 6f 64 65 20 74 6f 20 74  source code to t
2f20: 68 65 20 73 71 6c 69 74 65 33 20 70 72 6f 67 72  he sqlite3 progr
2f30: 61 6d 0a 28 66 6f 75 6e 64 20 69 6e 20 74 68 65  am.(found in the
2f40: 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 6e 20   source tree in 
2f50: 74 68 65 20 66 69 6c 65 20 73 72 63 2f 73 68 65  the file src/she
2f60: 6c 6c 2e 63 29 20 79 6f 75 27 6c 6c 20 66 69 6e  ll.c) you'll fin
2f70: 64 0a 65 78 61 63 74 6c 79 20 74 68 65 20 61 62  d.exactly the ab
2f80: 6f 76 65 20 71 75 65 72 79 2e 3c 2f 70 3e 0a 0a  ove query.</p>..
2f90: 3c 70 3e 54 68 65 20 22 2e 69 6e 64 69 63 65 73  <p>The ".indices
2fa0: 22 20 63 6f 6d 6d 61 6e 64 20 77 6f 72 6b 73 20  " command works 
2fb0: 69 6e 20 61 20 73 69 6d 69 6c 61 72 20 77 61 79  in a similar way
2fc0: 20 74 6f 20 6c 69 73 74 20 61 6c 6c 20 6f 66 0a   to list all of.
2fd0: 74 68 65 20 69 6e 64 69 63 65 73 20 66 6f 72 20  the indices for 
2fe0: 61 20 70 61 72 74 69 63 75 6c 61 72 20 74 61 62  a particular tab
2ff0: 6c 65 2e 20 20 54 68 65 20 22 2e 69 6e 64 69 63  le.  The ".indic
3000: 65 73 22 20 63 6f 6d 6d 61 6e 64 20 74 61 6b 65  es" command take
3010: 73 0a 61 20 73 69 6e 67 6c 65 20 61 72 67 75 6d  s.a single argum
3020: 65 6e 74 20 77 68 69 63 68 20 69 73 20 74 68 65  ent which is the
3030: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
3040: 6c 65 20 66 6f 72 20 77 68 69 63 68 20 74 68 65  le for which the
3050: 0a 69 6e 64 69 63 65 73 20 61 72 65 20 64 65 73  .indices are des
3060: 69 72 65 64 2e 20 20 4c 61 73 74 2c 20 62 75 74  ired.  Last, but
3070: 20 6e 6f 74 20 6c 65 61 73 74 2c 20 69 73 20 74   not least, is t
3080: 68 65 20 22 2e 73 63 68 65 6d 61 22 20 63 6f 6d  he ".schema" com
3090: 6d 61 6e 64 2e 0a 57 69 74 68 20 6e 6f 20 61 72  mand..With no ar
30a0: 67 75 6d 65 6e 74 73 2c 20 74 68 65 20 22 2e 73  guments, the ".s
30b0: 63 68 65 6d 61 22 20 63 6f 6d 6d 61 6e 64 20 73  chema" command s
30c0: 68 6f 77 73 20 74 68 65 20 6f 72 69 67 69 6e 61  hows the origina
30d0: 6c 20 43 52 45 41 54 45 20 54 41 42 4c 45 0a 61  l CREATE TABLE.a
30e0: 6e 64 20 43 52 45 41 54 45 20 49 4e 44 45 58 20  nd CREATE INDEX 
30f0: 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20  statements that 
3100: 77 65 72 65 20 75 73 65 64 20 74 6f 20 62 75 69  were used to bui
3110: 6c 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 64  ld the current d
3120: 61 74 61 62 61 73 65 2e 0a 49 66 20 79 6f 75 20  atabase..If you 
3130: 67 69 76 65 20 74 68 65 20 6e 61 6d 65 20 6f 66  give the name of
3140: 20 61 20 74 61 62 6c 65 20 74 6f 20 22 2e 73 63   a table to ".sc
3150: 68 65 6d 61 22 2c 20 69 74 20 73 68 6f 77 73 20  hema", it shows 
3160: 74 68 65 20 6f 72 69 67 69 6e 61 6c 0a 43 52 45  the original.CRE
3170: 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20 75 73  ATE statement us
3180: 65 64 20 74 6f 20 6d 61 6b 65 20 74 68 61 74 20  ed to make that 
3190: 74 61 62 6c 65 20 61 6e 64 20 61 6c 6c 20 69 66  table and all if
31a0: 20 69 74 73 20 69 6e 64 69 63 65 73 2e 0a 57 65   its indices..We
31b0: 20 68 61 76 65 3a 3c 2f 70 3e 0a 0a 3c 74 63 6c   have:</p>..<tcl
31c0: 3e 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65 3e 20  >Code {.sqlite> 
31d0: 28 28 28 2e 73 63 68 65 6d 61 29 29 29 0a 63 72  (((.schema))).cr
31e0: 65 61 74 65 20 74 61 62 6c 65 20 74 62 6c 31 28  eate table tbl1(
31f0: 6f 6e 65 20 76 61 72 63 68 61 72 28 31 30 29 2c  one varchar(10),
3200: 20 74 77 6f 20 73 6d 61 6c 6c 69 6e 74 29 0a 43   two smallint).C
3210: 52 45 41 54 45 20 54 41 42 4c 45 20 74 62 6c 32  REATE TABLE tbl2
3220: 20 28 0a 20 20 66 31 20 76 61 72 63 68 61 72 28   (.  f1 varchar(
3230: 33 30 29 20 70 72 69 6d 61 72 79 20 6b 65 79 2c  30) primary key,
3240: 0a 20 20 66 32 20 74 65 78 74 2c 0a 20 20 66 33  .  f2 text,.  f3
3250: 20 72 65 61 6c 0a 29 0a 73 71 6c 69 74 65 3e 20   real.).sqlite> 
3260: 28 28 28 2e 73 63 68 65 6d 61 20 74 62 6c 32 29  (((.schema tbl2)
3270: 29 29 0a 43 52 45 41 54 45 20 54 41 42 4c 45 20  )).CREATE TABLE 
3280: 74 62 6c 32 20 28 0a 20 20 66 31 20 76 61 72 63  tbl2 (.  f1 varc
3290: 68 61 72 28 33 30 29 20 70 72 69 6d 61 72 79 20  har(30) primary 
32a0: 6b 65 79 2c 0a 20 20 66 32 20 74 65 78 74 2c 0a  key,.  f2 text,.
32b0: 20 20 66 33 20 72 65 61 6c 0a 29 0a 73 71 6c 69    f3 real.).sqli
32c0: 74 65 3e 0a 7d 3c 2f 74 63 6c 3e 0a 0a 0a 3c 70  te>.}</tcl>...<p
32d0: 3e 54 68 65 20 22 2e 73 63 68 65 6d 61 22 20 63  >The ".schema" c
32e0: 6f 6d 6d 61 6e 64 20 61 63 63 6f 6d 70 6c 69 73  ommand accomplis
32f0: 68 65 73 20 74 68 65 20 73 61 6d 65 20 74 68 69  hes the same thi
3300: 6e 67 20 61 73 20 73 65 74 74 69 6e 67 0a 6c 69  ng as setting.li
3310: 73 74 20 6d 6f 64 65 2c 20 74 68 65 6e 20 65 6e  st mode, then en
3320: 74 65 72 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f  tering the follo
3330: 77 69 6e 67 20 71 75 65 72 79 3a 3c 2f 70 3e 0a  wing query:</p>.
3340: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
3350: 65 3e 0a 53 45 4c 45 43 54 20 73 71 6c 20 46 52  e>.SELECT sql FR
3360: 4f 4d 20 0a 20 20 20 28 53 45 4c 45 43 54 20 2a  OM .   (SELECT *
3370: 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73   FROM sqlite_mas
3380: 74 65 72 20 55 4e 49 4f 4e 20 41 4c 4c 0a 20 20  ter UNION ALL.  
3390: 20 20 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20    SELECT * FROM 
33a0: 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74  sqlite_temp_mast
33b0: 65 72 29 0a 57 48 45 52 45 20 74 79 70 65 21 3d  er).WHERE type!=
33c0: 27 6d 65 74 61 27 0a 4f 52 44 45 52 20 42 59 20  'meta'.ORDER BY 
33d0: 74 62 6c 5f 6e 61 6d 65 2c 20 74 79 70 65 20 44  tbl_name, type D
33e0: 45 53 43 2c 20 6e 61 6d 65 0a 3c 2f 70 72 65 3e  ESC, name.</pre>
33f0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c  </blockquote>..<
3400: 70 3e 4f 72 2c 20 69 66 20 79 6f 75 20 67 69 76  p>Or, if you giv
3410: 65 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f  e an argument to
3420: 20 22 2e 73 63 68 65 6d 61 22 20 62 65 63 61 75   ".schema" becau
3430: 73 65 20 79 6f 75 20 6f 6e 6c 79 0a 77 61 6e 74  se you only.want
3440: 20 74 68 65 20 73 63 68 65 6d 61 20 66 6f 72 20   the schema for 
3450: 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 2c 20  a single table, 
3460: 74 68 65 20 71 75 65 72 79 20 6c 6f 6f 6b 73 20  the query looks 
3470: 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a  like this:</p>..
3480: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65  <blockquote><pre
3490: 3e 0a 53 45 4c 45 43 54 20 73 71 6c 20 46 52 4f  >.SELECT sql FRO
34a0: 4d 0a 20 20 20 28 53 45 4c 45 43 54 20 2a 20 46  M.   (SELECT * F
34b0: 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65  ROM sqlite_maste
34c0: 72 20 55 4e 49 4f 4e 20 41 4c 4c 0a 20 20 20 20  r UNION ALL.    
34d0: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 73 71  SELECT * FROM sq
34e0: 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72  lite_temp_master
34f0: 29 0a 57 48 45 52 45 20 74 79 70 65 21 3d 27 6d  ).WHERE type!='m
3500: 65 74 61 27 20 41 4e 44 20 73 71 6c 20 4e 4f 54  eta' AND sql NOT
3510: 20 4e 55 4c 4c 20 41 4e 44 20 6e 61 6d 65 20 4e   NULL AND name N
3520: 4f 54 20 4c 49 4b 45 20 27 73 71 6c 69 74 65 5f  OT LIKE 'sqlite_
3530: 25 27 0a 4f 52 44 45 52 20 42 59 20 73 75 62 73  %'.ORDER BY subs
3540: 74 72 28 74 79 70 65 2c 32 2c 31 29 2c 20 6e 61  tr(type,2,1), na
3550: 6d 65 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b  me.</pre></block
3560: 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 59 6f 75 20  quote>..<p>.You 
3570: 63 61 6e 20 73 75 70 70 6c 79 20 61 6e 20 61 72  can supply an ar
3580: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 2e 73  gument to the .s
3590: 63 68 65 6d 61 20 63 6f 6d 6d 61 6e 64 2e 20 20  chema command.  
35a0: 49 66 20 79 6f 75 20 64 6f 2c 20 74 68 65 0a 71  If you do, the.q
35b0: 75 65 72 79 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20  uery looks like 
35c0: 74 68 69 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f  this:.</p>..<blo
35d0: 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 53 45  ckquote><pre>.SE
35e0: 4c 45 43 54 20 73 71 6c 20 46 52 4f 4d 0a 20 20  LECT sql FROM.  
35f0: 20 28 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20   (SELECT * FROM 
3600: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 55 4e  sqlite_master UN
3610: 49 4f 4e 20 41 4c 4c 0a 20 20 20 20 53 45 4c 45  ION ALL.    SELE
3620: 43 54 20 2a 20 46 52 4f 4d 20 73 71 6c 69 74 65  CT * FROM sqlite
3630: 5f 74 65 6d 70 5f 6d 61 73 74 65 72 29 0a 57 48  _temp_master).WH
3640: 45 52 45 20 74 62 6c 5f 6e 61 6d 65 20 4c 49 4b  ERE tbl_name LIK
3650: 45 20 27 25 73 27 0a 20 20 41 4e 44 20 74 79 70  E '%s'.  AND typ
3660: 65 21 3d 27 6d 65 74 61 27 20 41 4e 44 20 73 71  e!='meta' AND sq
3670: 6c 20 4e 4f 54 20 4e 55 4c 4c 20 41 4e 44 20 6e  l NOT NULL AND n
3680: 61 6d 65 20 4e 4f 54 20 4c 49 4b 45 20 27 73 71  ame NOT LIKE 'sq
3690: 6c 69 74 65 5f 25 27 0a 4f 52 44 45 52 20 42 59  lite_%'.ORDER BY
36a0: 20 73 75 62 73 74 72 28 74 79 70 65 2c 32 2c 31   substr(type,2,1
36b0: 29 2c 20 6e 61 6d 65 0a 3c 2f 70 72 65 3e 3c 2f  ), name.</pre></
36c0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e  blockquote>..<p>
36d0: 54 68 65 20 22 25 73 22 20 69 6e 20 74 68 65 20  The "%s" in the 
36e0: 71 75 65 72 79 20 69 73 20 72 65 70 6c 61 63 65  query is replace
36f0: 20 62 79 20 79 6f 75 72 20 61 72 67 75 6d 65 6e   by your argumen
3700: 74 2e 20 20 54 68 69 73 20 61 6c 6c 6f 77 73 20  t.  This allows 
3710: 79 6f 75 0a 74 6f 20 76 69 65 77 20 74 68 65 20  you.to view the 
3720: 73 63 68 65 6d 61 20 66 6f 72 20 73 6f 6d 65 20  schema for some 
3730: 73 75 62 73 65 74 20 6f 66 20 74 68 65 20 64 61  subset of the da
3740: 74 61 62 61 73 65 2e 3c 2f 70 3e 0a 0a 0a 3c 74  tabase.</p>...<t
3750: 63 6c 3e 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65  cl>Code {.sqlite
3760: 3e 20 28 28 28 2e 73 63 68 65 6d 61 20 25 61 62  > (((.schema %ab
3770: 63 25 29 29 29 0a 7d 3c 2f 74 63 6c 3e 0a 0a 0a  c%))).}</tcl>...
3780: 3c 70 3e 0a 41 6c 6f 6e 67 20 74 68 65 73 65 20  <p>.Along these 
3790: 73 61 6d 65 20 6c 69 6e 65 73 2c 0a 74 68 65 20  same lines,.the 
37a0: 22 2e 74 61 62 6c 65 22 20 63 6f 6d 6d 61 6e 64  ".table" command
37b0: 20 61 6c 73 6f 20 61 63 63 65 70 74 73 20 61 20   also accepts a 
37c0: 70 61 74 74 65 72 6e 20 61 73 20 69 74 73 20 66  pattern as its f
37d0: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a 49  irst argument..I
37e0: 66 20 79 6f 75 20 67 69 76 65 20 61 6e 20 61 72  f you give an ar
37f0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 2e 74  gument to the .t
3800: 61 62 6c 65 20 63 6f 6d 6d 61 6e 64 2c 20 61 20  able command, a 
3810: 22 25 22 20 69 73 20 62 6f 74 68 0a 61 70 70 65  "%" is both.appe
3820: 6e 64 65 64 20 61 6e 64 20 70 72 65 70 65 6e 64  nded and prepend
3830: 65 64 20 61 6e 64 20 61 20 4c 49 4b 45 20 63 6c  ed and a LIKE cl
3840: 61 75 73 65 20 69 73 20 61 64 64 65 64 20 74 6f  ause is added to
3850: 20 74 68 65 20 71 75 65 72 79 2e 0a 54 68 69 73   the query..This
3860: 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 6c   allows you to l
3870: 69 73 74 20 6f 6e 6c 79 20 74 68 6f 73 65 20 74  ist only those t
3880: 61 62 6c 65 73 20 74 68 61 74 20 6d 61 74 63 68  ables that match
3890: 20 61 20 70 61 72 74 69 63 75 6c 61 72 0a 70 61   a particular.pa
38a0: 74 74 65 72 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  ttern.</p>..<p>T
38b0: 68 65 20 22 2e 64 61 74 61 62 61 73 65 73 22 20  he ".databases" 
38c0: 63 6f 6d 6d 61 6e 64 20 73 68 6f 77 73 20 61 20  command shows a 
38d0: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 64 61 74 61  list of all data
38e0: 62 61 73 65 73 20 6f 70 65 6e 20 69 6e 0a 74 68  bases open in.th
38f0: 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 6e 65 63  e current connec
3900: 74 69 6f 6e 2e 20 20 54 68 65 72 65 20 77 69 6c  tion.  There wil
3910: 6c 20 61 6c 77 61 79 73 20 62 65 20 61 74 20 6c  l always be at l
3920: 65 61 73 74 20 32 2e 20 20 54 68 65 20 66 69 72  east 2.  The fir
3930: 73 74 0a 6f 6e 65 20 69 73 20 22 6d 61 69 6e 22  st.one is "main"
3940: 2c 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 64  , the original d
3950: 61 74 61 62 61 73 65 20 6f 70 65 6e 65 64 2e 20  atabase opened. 
3960: 20 54 68 65 20 73 65 63 6f 6e 64 20 69 73 20 22   The second is "
3970: 74 65 6d 70 22 2c 0a 74 68 65 20 64 61 74 61 62  temp",.the datab
3980: 61 73 65 20 75 73 65 64 20 66 6f 72 20 74 65 6d  ase used for tem
3990: 70 6f 72 61 72 79 20 74 61 62 6c 65 73 2e 20 54  porary tables. T
39a0: 68 65 72 65 20 6d 61 79 20 62 65 20 61 64 64 69  here may be addi
39b0: 74 69 6f 6e 61 6c 20 0a 64 61 74 61 62 61 73 65  tional .database
39c0: 73 20 6c 69 73 74 65 64 20 66 6f 72 20 64 61 74  s listed for dat
39d0: 61 62 61 73 65 73 20 61 74 74 61 63 68 65 64 20  abases attached 
39e0: 75 73 69 6e 67 20 74 68 65 20 41 54 54 41 43 48  using the ATTACH
39f0: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 54 68 65 20   statement..The 
3a00: 66 69 72 73 74 20 6f 75 74 70 75 74 20 63 6f 6c  first output col
3a10: 75 6d 6e 20 69 73 20 74 68 65 20 6e 61 6d 65 20  umn is the name 
3a20: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
3a30: 61 74 74 61 63 68 65 64 20 77 69 74 68 2c 20 0a  attached with, .
3a40: 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20 63  and the second c
3a50: 6f 6c 75 6d 6e 20 69 73 20 74 68 65 20 66 69 6c  olumn is the fil
3a60: 65 6e 61 6d 65 20 6f 66 20 74 68 65 20 65 78 74  ename of the ext
3a70: 65 72 6e 61 6c 20 66 69 6c 65 2e 3c 2f 70 3e 0a  ernal file.</p>.
3a80: 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a 73 71 6c  .<tcl>Code {.sql
3a90: 69 74 65 3e 20 28 28 28 2e 64 61 74 61 62 61 73  ite> (((.databas
3aa0: 65 73 29 29 29 0a 7d 3c 2f 74 63 6c 3e 0a 0a 0a  es))).}</tcl>...
3ab0: 3c 68 33 3e 43 6f 6e 76 65 72 74 69 6e 67 20 41  <h3>Converting A
3ac0: 6e 20 45 6e 74 69 72 65 20 44 61 74 61 62 61 73  n Entire Databas
3ad0: 65 20 54 6f 20 41 6e 20 41 53 43 49 49 20 54 65  e To An ASCII Te
3ae0: 78 74 20 46 69 6c 65 3c 2f 68 33 3e 0a 0a 3c 70  xt File</h3>..<p
3af0: 3e 55 73 65 20 74 68 65 20 22 2e 64 75 6d 70 22  >Use the ".dump"
3b00: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 6f 6e 76   command to conv
3b10: 65 72 74 20 74 68 65 20 65 6e 74 69 72 65 20 63  ert the entire c
3b20: 6f 6e 74 65 6e 74 73 20 6f 66 20 61 0a 64 61 74  ontents of a.dat
3b30: 61 62 61 73 65 20 69 6e 74 6f 20 61 20 73 69 6e  abase into a sin
3b40: 67 6c 65 20 41 53 43 49 49 20 74 65 78 74 20 66  gle ASCII text f
3b50: 69 6c 65 2e 20 20 54 68 69 73 20 66 69 6c 65 20  ile.  This file 
3b60: 63 61 6e 20 62 65 20 63 6f 6e 76 65 72 74 65 64  can be converted
3b70: 0a 62 61 63 6b 20 69 6e 74 6f 20 61 20 64 61 74  .back into a dat
3b80: 61 62 61 73 65 20 62 79 20 70 69 70 69 6e 67 20  abase by piping 
3b90: 69 74 20 62 61 63 6b 20 69 6e 74 6f 20 3c 62 3e  it back into <b>
3ba0: 73 71 6c 69 74 65 33 3c 2f 62 3e 2e 3c 2f 70 3e  sqlite3</b>.</p>
3bb0: 0a 0a 3c 70 3e 41 20 67 6f 6f 64 20 77 61 79 20  ..<p>A good way 
3bc0: 74 6f 20 6d 61 6b 65 20 61 6e 20 61 72 63 68 69  to make an archi
3bd0: 76 61 6c 20 63 6f 70 79 20 6f 66 20 61 20 64 61  val copy of a da
3be0: 74 61 62 61 73 65 20 69 73 20 74 68 69 73 3a 3c  tabase is this:<
3bf0: 2f 70 3e 0a 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20  /p>...<tcl>Code 
3c00: 7b 0a 24 20 28 28 28 65 63 68 6f 20 27 2e 64 75  {.$ (((echo '.du
3c10: 6d 70 27 20 7c 20 73 71 6c 69 74 65 33 20 65 78  mp' | sqlite3 ex
3c20: 31 20 7c 20 67 7a 69 70 20 2d 63 20 3e 65 78 31  1 | gzip -c >ex1
3c30: 2e 64 75 6d 70 2e 67 7a 29 29 29 0a 7d 3c 2f 74  .dump.gz))).}</t
3c40: 63 6c 3e 0a 0a 0a 3c 70 3e 54 68 69 73 20 67 65  cl>...<p>This ge
3c50: 6e 65 72 61 74 65 73 20 61 20 66 69 6c 65 20 6e  nerates a file n
3c60: 61 6d 65 64 20 3c 62 3e 65 78 31 2e 64 75 6d 70  amed <b>ex1.dump
3c70: 2e 67 7a 3c 2f 62 3e 20 74 68 61 74 20 63 6f 6e  .gz</b> that con
3c80: 74 61 69 6e 73 20 65 76 65 72 79 74 68 69 6e 67  tains everything
3c90: 0a 79 6f 75 20 6e 65 65 64 20 74 6f 20 72 65 63  .you need to rec
3ca0: 6f 6e 73 74 72 75 63 74 20 74 68 65 20 64 61 74  onstruct the dat
3cb0: 61 62 61 73 65 20 61 74 20 61 20 6c 61 74 65 72  abase at a later
3cc0: 20 74 69 6d 65 2c 20 6f 72 20 6f 6e 20 61 6e 6f   time, or on ano
3cd0: 74 68 65 72 0a 6d 61 63 68 69 6e 65 2e 20 20 54  ther.machine.  T
3ce0: 6f 20 72 65 63 6f 6e 73 74 72 75 63 74 20 74 68  o reconstruct th
3cf0: 65 20 64 61 74 61 62 61 73 65 2c 20 6a 75 73 74  e database, just
3d00: 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a 0a 3c 74 63   type:</p>...<tc
3d10: 6c 3e 43 6f 64 65 20 7b 0a 24 20 28 28 28 7a 63  l>Code {.$ (((zc
3d20: 61 74 20 65 78 31 2e 64 75 6d 70 2e 67 7a 20 7c  at ex1.dump.gz |
3d30: 20 73 71 6c 69 74 65 33 20 65 78 32 29 29 29 0a   sqlite3 ex2))).
3d40: 7d 3c 2f 74 63 6c 3e 0a 0a 0a 3c 70 3e 54 68 65  }</tcl>...<p>The
3d50: 20 74 65 78 74 20 66 6f 72 6d 61 74 20 69 73 20   text format is 
3d60: 70 75 72 65 20 53 51 4c 20 73 6f 20 79 6f 75 0a  pure SQL so you.
3d70: 63 61 6e 20 61 6c 73 6f 20 75 73 65 20 74 68 65  can also use the
3d80: 20 2e 64 75 6d 70 20 63 6f 6d 6d 61 6e 64 20 74   .dump command t
3d90: 6f 20 65 78 70 6f 72 74 20 61 6e 20 53 51 4c 69  o export an SQLi
3da0: 74 65 20 64 61 74 61 62 61 73 65 0a 69 6e 74 6f  te database.into
3db0: 20 6f 74 68 65 72 20 70 6f 70 75 6c 61 72 20 53   other popular S
3dc0: 51 4c 20 64 61 74 61 62 61 73 65 20 65 6e 67 69  QL database engi
3dd0: 6e 65 73 2e 20 20 4c 69 6b 65 20 74 68 69 73 3a  nes.  Like this:
3de0: 3c 2f 70 3e 0a 0a 0a 3c 74 63 6c 3e 43 6f 64 65  </p>...<tcl>Code
3df0: 20 7b 0a 24 20 28 28 28 63 72 65 61 74 65 64 62   {.$ (((createdb
3e00: 20 65 78 32 29 29 29 0a 24 20 28 28 28 73 71 6c   ex2))).$ (((sql
3e10: 69 74 65 33 20 65 78 31 20 2e 64 75 6d 70 20 7c  ite3 ex1 .dump |
3e20: 20 70 73 71 6c 20 65 78 32 29 29 29 0a 7d 3c 2f   psql ex2))).}</
3e30: 74 63 6c 3e 0a 0a 0a 3c 68 33 3e 4f 74 68 65 72  tcl>...<h3>Other
3e40: 20 44 6f 74 20 43 6f 6d 6d 61 6e 64 73 3c 2f 68   Dot Commands</h
3e50: 33 3e 0a 0a 3c 70 3e 54 68 65 20 22 2e 65 78 70  3>..<p>The ".exp
3e60: 6c 61 69 6e 22 20 64 6f 74 20 63 6f 6d 6d 61 6e  lain" dot comman
3e70: 64 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  d can be used to
3e80: 20 73 65 74 20 74 68 65 20 6f 75 74 70 75 74 20   set the output 
3e90: 6d 6f 64 65 0a 74 6f 20 22 63 6f 6c 75 6d 6e 22  mode.to "column"
3ea0: 20 61 6e 64 20 74 6f 20 73 65 74 20 74 68 65 20   and to set the 
3eb0: 63 6f 6c 75 6d 6e 20 77 69 64 74 68 73 20 74 6f  column widths to
3ec0: 20 76 61 6c 75 65 73 20 74 68 61 74 20 61 72 65   values that are
3ed0: 20 72 65 61 73 6f 6e 61 62 6c 65 0a 66 6f 72 20   reasonable.for 
3ee0: 6c 6f 6f 6b 69 6e 67 20 61 74 20 74 68 65 20 6f  looking at the o
3ef0: 75 74 70 75 74 20 6f 66 20 61 6e 20 45 58 50 4c  utput of an EXPL
3f00: 41 49 4e 20 63 6f 6d 6d 61 6e 64 2e 20 20 54 68  AIN command.  Th
3f10: 65 20 45 58 50 4c 41 49 4e 20 63 6f 6d 6d 61 6e  e EXPLAIN comman
3f20: 64 0a 69 73 20 61 6e 20 53 51 4c 69 74 65 2d 73  d.is an SQLite-s
3f30: 70 65 63 69 66 69 63 20 53 51 4c 20 65 78 74 65  pecific SQL exte
3f40: 6e 73 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73  nsion that is us
3f50: 65 66 75 6c 20 66 6f 72 20 64 65 62 75 67 67 69  eful for debuggi
3f60: 6e 67 2e 20 20 49 66 20 61 6e 79 0a 72 65 67 75  ng.  If any.regu
3f70: 6c 61 72 20 53 51 4c 20 69 73 20 70 72 65 66 61  lar SQL is prefa
3f80: 63 65 64 20 62 79 20 45 58 50 4c 41 49 4e 2c 20  ced by EXPLAIN, 
3f90: 74 68 65 6e 20 74 68 65 20 53 51 4c 20 63 6f 6d  then the SQL com
3fa0: 6d 61 6e 64 20 69 73 20 70 61 72 73 65 64 20 61  mand is parsed a
3fb0: 6e 64 0a 61 6e 61 6c 79 7a 65 64 20 62 75 74 20  nd.analyzed but 
3fc0: 69 73 20 6e 6f 74 20 65 78 65 63 75 74 65 64 2e  is not executed.
3fd0: 20 20 49 6e 73 74 65 61 64 2c 20 74 68 65 20 73    Instead, the s
3fe0: 65 71 75 65 6e 63 65 20 6f 66 20 76 69 72 74 75  equence of virtu
3ff0: 61 6c 20 6d 61 63 68 69 6e 65 0a 69 6e 73 74 72  al machine.instr
4000: 75 63 74 69 6f 6e 73 20 74 68 61 74 20 77 6f 75  uctions that wou
4010: 6c 64 20 68 61 76 65 20 62 65 65 6e 20 75 73 65  ld have been use
4020: 64 20 74 6f 20 65 78 65 63 75 74 65 20 74 68 65  d to execute the
4030: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 20 61 72 65   SQL command are
4040: 0a 72 65 74 75 72 6e 65 64 20 6c 69 6b 65 20 61  .returned like a
4050: 20 71 75 65 72 79 20 72 65 73 75 6c 74 2e 20 20   query result.  
4060: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e  For example:</p>
4070: 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a 73 71  ..<tcl>Code {.sq
4080: 6c 69 74 65 3e 20 28 28 28 2e 65 78 70 6c 61 69  lite> (((.explai
4090: 6e 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28  n))).sqlite> (((
40a0: 65 78 70 6c 61 69 6e 20 64 65 6c 65 74 65 20 66  explain delete f
40b0: 72 6f 6d 20 74 62 6c 31 20 77 68 65 72 65 20 74  rom tbl1 where t
40c0: 77 6f 3c 32 30 3b 29 29 29 0a 61 64 64 72 20 20  wo<20;))).addr  
40d0: 6f 70 63 6f 64 65 20 20 20 20 20 20 20 20 70 31  opcode        p1
40e0: 20 20 20 20 20 70 32 20 20 20 20 20 70 33 20 20       p2     p3  
40f0: 20 20 20 20 20 20 20 20 0a 2d 2d 2d 2d 20 20 2d          .----  -
4100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d  -----------  ---
4110: 2d 2d 20 20 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d 2d  --  -----  -----
4120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4130: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4140: 20 20 20 0a 30 20 20 20 20 20 4c 69 73 74 4f 70     .0     ListOp
4150: 65 6e 20 20 20 20 20 20 30 20 20 20 20 20 20 30  en      0      0
4160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4170: 20 20 0a 31 20 20 20 20 20 4f 70 65 6e 20 20 20    .1     Open   
4180: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 31 20         0      1 
4190: 20 20 20 20 20 74 62 6c 31 20 20 20 20 20 20 20       tbl1       
41a0: 20 0a 32 20 20 20 20 20 4e 65 78 74 20 20 20 20   .2     Next    
41b0: 20 20 20 20 20 20 30 20 20 20 20 20 20 39 20 20        0      9  
41c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
41d0: 0a 33 20 20 20 20 20 46 69 65 6c 64 20 20 20 20  .3     Field    
41e0: 20 20 20 20 20 30 20 20 20 20 20 20 31 20 20 20       0      1   
41f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
4200: 34 20 20 20 20 20 49 6e 74 65 67 65 72 20 20 20  4     Integer   
4210: 20 20 20 20 32 30 20 20 20 20 20 30 20 20 20 20      20     0    
4220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 35                .5
4230: 20 20 20 20 20 47 65 20 20 20 20 20 20 20 20 20       Ge         
4240: 20 20 20 30 20 20 20 20 20 20 32 20 20 20 20 20     0      2     
4250: 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 36 20               .6 
4260: 20 20 20 20 4b 65 79 20 20 20 20 20 20 20 20 20      Key         
4270: 20 20 30 20 20 20 20 20 20 30 20 20 20 20 20 20    0      0      
4280: 20 20 20 20 20 20 20 20 20 20 20 20 0a 37 20 20              .7  
4290: 20 20 20 4c 69 73 74 57 72 69 74 65 20 20 20 20     ListWrite    
42a0: 20 30 20 20 20 20 20 20 30 20 20 20 20 20 20 20   0      0       
42b0: 20 20 20 20 20 20 20 20 20 20 20 0a 38 20 20 20             .8   
42c0: 20 20 47 6f 74 6f 20 20 20 20 20 20 20 20 20 20    Goto          
42d0: 30 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20  0      2        
42e0: 20 20 20 20 20 20 20 20 20 20 0a 39 20 20 20 20            .9    
42f0: 20 4e 6f 6f 70 20 20 20 20 20 20 20 20 20 20 30   Noop          0
4300: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
4310: 20 20 20 20 20 20 20 20 20 0a 31 30 20 20 20 20           .10    
4320: 4c 69 73 74 52 65 77 69 6e 64 20 20 20 20 30 20  ListRewind    0 
4330: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
4340: 20 20 20 20 20 20 20 20 0a 31 31 20 20 20 20 4c          .11    L
4350: 69 73 74 52 65 61 64 20 20 20 20 20 20 30 20 20  istRead      0  
4360: 20 20 20 20 31 34 20 20 20 20 20 20 20 20 20 20      14          
4370: 20 20 20 20 20 20 20 0a 31 32 20 20 20 20 44 65         .12    De
4380: 6c 65 74 65 20 20 20 20 20 20 20 20 30 20 20 20  lete        0   
4390: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20     0            
43a0: 20 20 20 20 20 20 0a 31 33 20 20 20 20 47 6f 74        .13    Got
43b0: 6f 20 20 20 20 20 20 20 20 20 20 30 20 20 20 20  o          0    
43c0: 20 20 31 31 20 20 20 20 20 20 20 20 20 20 20 20    11            
43d0: 20 20 20 20 20 0a 31 34 20 20 20 20 4c 69 73 74       .14    List
43e0: 43 6c 6f 73 65 20 20 20 20 20 30 20 20 20 20 20  Close     0     
43f0: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20   0              
4400: 20 20 20 20 0a 7d 3c 2f 74 63 6c 3e 0a 0a 0a 0a      .}</tcl>....
4410: 3c 70 3e 54 68 65 20 22 2e 74 69 6d 65 6f 75 74  <p>The ".timeout
4420: 22 20 63 6f 6d 6d 61 6e 64 20 73 65 74 73 20 74  " command sets t
4430: 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d  he amount of tim
4440: 65 20 74 68 61 74 20 74 68 65 20 3c 62 3e 73 71  e that the <b>sq
4450: 6c 69 74 65 33 3c 2f 62 3e 0a 70 72 6f 67 72 61  lite3</b>.progra
4460: 6d 20 77 69 6c 6c 20 77 61 69 74 20 66 6f 72 20  m will wait for 
4470: 6c 6f 63 6b 73 20 74 6f 20 63 6c 65 61 72 20 6f  locks to clear o
4480: 6e 20 66 69 6c 65 73 20 69 74 20 69 73 20 74 72  n files it is tr
4490: 79 69 6e 67 20 74 6f 20 61 63 63 65 73 73 0a 62  ying to access.b
44a0: 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20  efore returning 
44b0: 61 6e 20 65 72 72 6f 72 2e 20 20 54 68 65 20 64  an error.  The d
44c0: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20  efault value of 
44d0: 74 68 65 20 74 69 6d 65 6f 75 74 20 69 73 20 7a  the timeout is z
44e0: 65 72 6f 20 73 6f 0a 74 68 61 74 20 61 6e 20 65  ero so.that an e
44f0: 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64  rror is returned
4500: 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 69 66 20   immediately if 
4510: 61 6e 79 20 6e 65 65 64 65 64 20 64 61 74 61 62  any needed datab
4520: 61 73 65 20 74 61 62 6c 65 20 6f 72 0a 69 6e 64  ase table or.ind
4530: 65 78 20 69 73 20 6c 6f 63 6b 65 64 2e 3c 2f 70  ex is locked.</p
4540: 3e 0a 0a 3c 70 3e 41 6e 64 20 66 69 6e 61 6c 6c  >..<p>And finall
4550: 79 2c 20 77 65 20 6d 65 6e 74 69 6f 6e 20 74 68  y, we mention th
4560: 65 20 22 2e 65 78 69 74 22 20 63 6f 6d 6d 61 6e  e ".exit" comman
4570: 64 20 77 68 69 63 68 20 63 61 75 73 65 73 20 74  d which causes t
4580: 68 65 0a 73 71 6c 69 74 65 33 20 70 72 6f 67 72  he.sqlite3 progr
4590: 61 6d 20 74 6f 20 65 78 69 74 2e 3c 2f 70 3e 0a  am to exit.</p>.
45a0: 0a 3c 68 33 3e 55 73 69 6e 67 20 73 71 6c 69 74  .<h3>Using sqlit
45b0: 65 33 20 69 6e 20 61 20 73 68 65 6c 6c 20 73 63  e3 in a shell sc
45c0: 72 69 70 74 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 4f  ript</h3>..<p>.O
45d0: 6e 65 20 77 61 79 20 74 6f 20 75 73 65 20 73 71  ne way to use sq
45e0: 6c 69 74 65 33 20 69 6e 20 61 20 73 68 65 6c 6c  lite3 in a shell
45f0: 20 73 63 72 69 70 74 20 69 73 20 74 6f 20 75 73   script is to us
4600: 65 20 22 65 63 68 6f 22 20 6f 72 0a 22 63 61 74  e "echo" or."cat
4610: 22 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 20  " to generate a 
4620: 73 65 71 75 65 6e 63 65 20 6f 66 20 63 6f 6d 6d  sequence of comm
4630: 61 6e 64 73 20 69 6e 20 61 20 66 69 6c 65 2c 20  ands in a file, 
4640: 74 68 65 6e 20 69 6e 76 6f 6b 65 20 73 71 6c 69  then invoke sqli
4650: 74 65 33 0a 77 68 69 6c 65 20 72 65 64 69 72 65  te3.while redire
4660: 63 74 69 6e 67 20 69 6e 70 75 74 20 66 72 6f 6d  cting input from
4670: 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20 63   the generated c
4680: 6f 6d 6d 61 6e 64 20 66 69 6c 65 2e 20 20 54 68  ommand file.  Th
4690: 69 73 0a 77 6f 72 6b 73 20 66 69 6e 65 20 61 6e  is.works fine an
46a0: 64 20 69 73 20 61 70 70 72 6f 70 72 69 61 74 65  d is appropriate
46b0: 20 69 6e 20 6d 61 6e 79 20 63 69 72 63 75 6d 73   in many circums
46c0: 74 61 6e 63 65 73 2e 20 20 42 75 74 20 61 73 0a  tances.  But as.
46d0: 61 6e 20 61 64 64 65 64 20 63 6f 6e 76 65 6e 69  an added conveni
46e0: 65 6e 63 65 2c 20 73 71 6c 69 74 65 33 20 61 6c  ence, sqlite3 al
46f0: 6c 6f 77 73 20 61 20 73 69 6e 67 6c 65 20 53 51  lows a single SQ
4700: 4c 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 62 65 0a  L command to be.
4710: 65 6e 74 65 72 65 64 20 6f 6e 20 74 68 65 20 63  entered on the c
4720: 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 73 20 61  ommand line as a
4730: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
4740: 20 61 66 74 65 72 20 74 68 65 0a 64 61 74 61 62   after the.datab
4750: 61 73 65 20 6e 61 6d 65 2e 20 20 57 68 65 6e 20  ase name.  When 
4760: 74 68 65 20 73 71 6c 69 74 65 33 20 70 72 6f 67  the sqlite3 prog
4770: 72 61 6d 20 69 73 20 6c 61 75 6e 63 68 65 64 20  ram is launched 
4780: 77 69 74 68 20 74 77 6f 0a 61 72 67 75 6d 65 6e  with two.argumen
4790: 74 73 2c 20 74 68 65 20 73 65 63 6f 6e 64 20 61  ts, the second a
47a0: 72 67 75 6d 65 6e 74 20 69 73 20 70 61 73 73 65  rgument is passe
47b0: 64 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65 20  d to the SQLite 
47c0: 6c 69 62 72 61 72 79 0a 66 6f 72 20 70 72 6f 63  library.for proc
47d0: 65 73 73 69 6e 67 2c 20 74 68 65 20 71 75 65 72  essing, the quer
47e0: 79 20 72 65 73 75 6c 74 73 20 61 72 65 20 70 72  y results are pr
47f0: 69 6e 74 65 64 20 6f 6e 20 73 74 61 6e 64 61 72  inted on standar
4800: 64 20 6f 75 74 70 75 74 0a 69 6e 20 6c 69 73 74  d output.in list
4810: 20 6d 6f 64 65 2c 20 61 6e 64 20 74 68 65 20 70   mode, and the p
4820: 72 6f 67 72 61 6d 20 65 78 69 74 73 2e 20 20 54  rogram exits.  T
4830: 68 69 73 20 6d 65 63 68 61 6e 69 73 6d 20 69 73  his mechanism is
4840: 20 64 65 73 69 67 6e 65 64 0a 74 6f 20 6d 61 6b   designed.to mak
4850: 65 20 73 71 6c 69 74 65 33 20 65 61 73 79 20 74  e sqlite3 easy t
4860: 6f 20 75 73 65 20 69 6e 20 63 6f 6e 6a 75 6e 63  o use in conjunc
4870: 74 69 6f 6e 20 77 69 74 68 20 70 72 6f 67 72 61  tion with progra
4880: 6d 73 20 6c 69 6b 65 0a 22 61 77 6b 22 2e 20 20  ms like."awk".  
4890: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e  For example:</p>
48a0: 0a 0a 3c 74 63 6c 3e 43 6f 64 65 20 7b 0a 24 20  ..<tcl>Code {.$ 
48b0: 28 28 28 73 71 6c 69 74 65 33 20 65 78 31 20 27  (((sqlite3 ex1 '
48c0: 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62  select * from tb
48d0: 6c 31 27 20 7c 29 29 29 0a 3e 20 28 28 28 20 61  l1' |))).> ((( a
48e0: 77 6b 20 27 7b 70 72 69 6e 74 66 20 22 3c 74 72  wk '{printf "<tr
48f0: 3e 3c 74 64 3e 25 73 3c 74 64 3e 25 73 5c 6e 22  ><td>%s<td>%s\n"
4900: 2c 24 31 2c 24 32 20 7d 27 29 29 29 0a 3c 74 72  ,$1,$2 }'))).<tr
4910: 3e 3c 74 64 3e 68 65 6c 6c 6f 3c 74 64 3e 31 30  ><td>hello<td>10
4920: 0a 3c 74 72 3e 3c 74 64 3e 67 6f 6f 64 62 79 65  .<tr><td>goodbye
4930: 3c 74 64 3e 32 30 0a 24 0a 7d 3c 2f 74 63 6c 3e  <td>20.$.}</tcl>
4940: 0a 0a 0a 3c 68 33 3e 45 6e 64 69 6e 67 20 73 68  ...<h3>Ending sh
4950: 65 6c 6c 20 63 6f 6d 6d 61 6e 64 73 3c 2f 68 33  ell commands</h3
4960: 3e 0a 0a 3c 70 3e 0a 53 51 4c 69 74 65 20 63 6f  >..<p>.SQLite co
4970: 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 72 6d 61  mmands are norma
4980: 6c 6c 79 20 74 65 72 6d 69 6e 61 74 65 64 20 62  lly terminated b
4990: 79 20 61 20 73 65 6d 69 63 6f 6c 6f 6e 2e 20 20  y a semicolon.  
49a0: 49 6e 20 74 68 65 20 73 68 65 6c 6c 20 0a 79 6f  In the shell .yo
49b0: 75 20 63 61 6e 20 61 6c 73 6f 20 75 73 65 20 74  u can also use t
49c0: 68 65 20 77 6f 72 64 20 22 47 4f 22 20 28 63 61  he word "GO" (ca
49d0: 73 65 2d 69 6e 73 65 6e 73 69 74 69 76 65 29 20  se-insensitive) 
49e0: 6f 72 20 61 20 73 6c 61 73 68 20 63 68 61 72 61  or a slash chara
49f0: 63 74 65 72 20 0a 22 2f 22 20 6f 6e 20 61 20 6c  cter ."/" on a l
4a00: 69 6e 65 20 62 79 20 69 74 73 65 6c 66 20 74 6f  ine by itself to
4a10: 20 65 6e 64 20 61 20 63 6f 6d 6d 61 6e 64 2e 20   end a command. 
4a20: 20 54 68 65 73 65 20 61 72 65 20 75 73 65 64 20   These are used 
4a30: 62 79 20 53 51 4c 20 53 65 72 76 65 72 20 0a 61  by SQL Server .a
4a40: 6e 64 20 4f 72 61 63 6c 65 2c 20 72 65 73 70 65  nd Oracle, respe
4a50: 63 74 69 76 65 6c 79 2e 20 20 54 68 65 73 65 20  ctively.  These 
4a60: 77 6f 6e 27 74 20 77 6f 72 6b 20 69 6e 20 3c 62  won't work in <b
4a70: 3e 73 71 6c 69 74 65 33 5f 65 78 65 63 28 29 3c  >sqlite3_exec()<
4a80: 2f 62 3e 2c 20 0a 62 65 63 61 75 73 65 20 74 68  /b>, .because th
4a90: 65 20 73 68 65 6c 6c 20 74 72 61 6e 73 6c 61 74  e shell translat
4aa0: 65 73 20 74 68 65 73 65 20 69 6e 74 6f 20 61 20  es these into a 
4ab0: 73 65 6d 69 63 6f 6c 6f 6e 20 62 65 66 6f 72 65  semicolon before
4ac0: 20 70 61 73 73 69 6e 67 20 74 68 65 6d 20 0a 74   passing them .t
4ad0: 6f 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 2e  o that function.
4ae0: 3c 2f 70 3e 0a 0a 0a 0a 3c 68 33 3e 43 6f 6d 70  </p>....<h3>Comp
4af0: 69 6c 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65  iling the sqlite
4b00: 33 20 70 72 6f 67 72 61 6d 20 66 72 6f 6d 20 73  3 program from s
4b10: 6f 75 72 63 65 73 3c 2f 68 33 3e 0a 0a 3c 70 3e  ources</h3>..<p>
4b20: 0a 54 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65  .The source code
4b30: 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 20   to the sqlite3 
4b40: 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 69 6e 74  command line int
4b50: 65 72 66 61 63 65 20 69 73 20 69 6e 20 61 20 73  erface is in a s
4b60: 69 6e 67 6c 65 0a 66 69 6c 65 20 6e 61 6d 65 64  ingle.file named
4b70: 20 22 73 68 65 6c 6c 2e 63 22 20 77 68 69 63 68   "shell.c" which
4b80: 20 79 6f 75 20 63 61 6e 0a 3c 61 20 68 72 65 66   you can.<a href
4b90: 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c  ="http://www.sql
4ba0: 69 74 65 2e 6f 72 67 2f 73 72 63 2f 66 69 6e 66  ite.org/src/finf
4bb0: 6f 3f 6e 61 6d 65 3d 73 72 63 2f 73 68 65 6c 6c  o?name=src/shell
4bc0: 2e 63 22 3e 0a 64 6f 77 6e 6c 6f 61 64 3c 2f 61  .c">.download</a
4bd0: 3e 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 69 74  > from the SQLit
4be0: 65 20 77 65 62 73 69 74 65 2e 20 20 43 6f 6d 70  e website.  Comp
4bf0: 69 6c 65 20 74 68 69 73 20 66 69 6c 65 20 28 74  ile this file (t
4c00: 6f 67 65 74 68 65 72 0a 77 69 74 68 20 74 68 65  ogether.with the
4c10: 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 20 7c   [amalgamation |
4c20: 20 73 71 6c 69 74 65 33 20 6c 69 62 72 61 72 79   sqlite3 library
4c30: 20 73 6f 75 72 63 65 20 63 6f 64 65 5d 20 74 6f   source code] to
4c40: 20 67 65 6e 65 72 61 74 65 0a 74 68 65 20 65 78   generate.the ex
4c50: 65 63 75 74 61 62 6c 65 2e 20 20 46 6f 72 20 65  ecutable.  For e
4c60: 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c  xample:</p>..<bl
4c70: 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 67  ockquote><pre>.g
4c80: 63 63 20 2d 6f 20 73 71 6c 69 74 65 33 20 73 68  cc -o sqlite3 sh
4c90: 65 6c 6c 2e 63 20 73 71 6c 69 74 65 33 2e 63 20  ell.c sqlite3.c 
4ca0: 2d 6c 64 6c 20 2d 6c 70 74 68 72 65 61 64 0a 3c  -ldl -lpthread.<
4cb0: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
4cc0: 65 3e 0a                                         e>.