Documentation Source Text

Hex Artifact Content
Login

Artifact f77be2ad48dcf733d4238e5a864f80b144cf5410:


0000: 3c 74 69 74 6c 65 3e 43 6c 75 73 74 65 72 65 64  <title>Clustered
0010: 20 49 6e 64 65 78 65 73 20 61 6e 64 20 74 68 65   Indexes and the
0020: 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 4f   WITHOUT ROWID O
0030: 70 74 69 6d 69 7a 61 74 69 6f 6e 3c 2f 74 69 74  ptimization</tit
0040: 6c 65 3e 0a 3c 74 63 6c 3e 0a 68 64 5f 6b 65 79  le>.<tcl>.hd_key
0050: 77 6f 72 64 73 20 7b 57 49 54 48 4f 55 54 20 72  words {WITHOUT r
0060: 6f 77 69 64 7d 20 7b 57 49 54 48 4f 55 54 20 52  owid} {WITHOUT R
0070: 4f 57 49 44 7d 20 7b 43 6c 75 73 74 65 72 65 64  OWID} {Clustered
0080: 20 69 6e 64 65 78 65 73 7d 0a 3c 2f 74 63 6c 3e   indexes}.</tcl>
0090: 0a 3c 66 61 6e 63 79 5f 66 6f 72 6d 61 74 3e 0a  .<fancy_format>.
00a0: 0a 3c 68 31 3e 49 6e 74 72 6f 64 75 63 74 69 6f  .<h1>Introductio
00b0: 6e 3c 2f 68 31 3e 0a 0a 3c 70 3e 5e 42 79 20 64  n</h1>..<p>^By d
00c0: 65 66 61 75 6c 74 2c 20 65 76 65 72 79 20 72 6f  efault, every ro
00d0: 77 20 69 6e 20 53 51 4c 69 74 65 20 68 61 73 20  w in SQLite has 
00e0: 61 20 73 70 65 63 69 61 6c 20 63 6f 6c 75 6d 6e  a special column
00f0: 2c 20 75 73 75 61 6c 6c 79 20 63 61 6c 6c 65 64  , usually called
0100: 20 74 68 65 0a 22 5b 72 6f 77 69 64 5d 22 2c 20   the."[rowid]", 
0110: 74 68 61 74 20 75 6e 69 71 75 65 6c 79 20 69 64  that uniquely id
0120: 65 6e 74 69 66 69 65 73 20 74 68 61 74 20 72 6f  entifies that ro
0130: 77 20 77 69 74 68 69 6e 20 74 68 65 20 74 61 62  w within the tab
0140: 6c 65 2e 20 20 5e 48 6f 77 65 76 65 72 0a 69 66  le.  ^However.if
0150: 20 74 68 65 20 70 68 72 61 73 65 20 22 57 49 54   the phrase "WIT
0160: 48 4f 55 54 20 52 4f 57 49 44 22 20 69 73 20 61  HOUT ROWID" is a
0170: 64 64 65 64 20 74 6f 20 74 68 65 20 65 6e 64 20  dded to the end 
0180: 6f 66 20 61 20 5b 43 52 45 41 54 45 20 54 41 42  of a [CREATE TAB
0190: 4c 45 5d 20 73 74 61 74 65 6d 65 6e 74 2c 0a 74  LE] statement,.t
01a0: 68 65 6e 20 74 68 65 20 73 70 65 63 69 61 6c 20  hen the special 
01b0: 22 72 6f 77 69 64 22 20 63 6f 6c 75 6d 6e 20 69  "rowid" column i
01c0: 73 20 6f 6d 69 74 74 65 64 2e 20 20 54 68 65 72  s omitted.  Ther
01d0: 65 20 61 72 65 20 73 6f 6d 65 74 69 6d 65 73 0a  e are sometimes.
01e0: 73 70 61 63 65 20 61 6e 64 20 70 65 72 66 6f 72  space and perfor
01f0: 6d 61 6e 63 65 20 61 64 76 61 6e 74 61 67 65 73  mance advantages
0200: 20 74 6f 20 6f 6d 69 74 74 69 6e 67 20 74 68 65   to omitting the
0210: 20 72 6f 77 69 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e   rowid.</p>..<p>
0220: 41 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20  A WITHOUT ROWID 
0230: 74 61 62 6c 65 20 69 73 20 61 20 74 61 62 6c 65  table is a table
0240: 20 74 68 61 74 20 75 73 65 73 20 61 20 0a 5b 68   that uses a .[h
0250: 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65  ttps://en.wikipe
0260: 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 44 61 74  dia.org/wiki/Dat
0270: 61 62 61 73 65 5f 69 6e 64 65 78 23 43 6c 75 73  abase_index#Clus
0280: 74 65 72 65 64 7c 43 6c 75 73 74 65 72 65 64 20  tered|Clustered 
0290: 49 6e 64 65 78 5d 0a 61 73 20 74 68 65 20 70 72  Index].as the pr
02a0: 69 6d 61 72 79 20 6b 65 79 2e 3c 2f 70 3e 0a 0a  imary key.</p>..
02b0: 3c 68 32 3e 53 79 6e 74 61 78 3c 2f 68 32 3e 0a  <h2>Syntax</h2>.
02c0: 0a 3c 70 3e 5e 28 54 6f 20 63 72 65 61 74 65 20  .<p>^(To create 
02d0: 61 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20  a WITHOUT ROWID 
02e0: 74 61 62 6c 65 2c 20 73 69 6d 70 6c 79 20 61 64  table, simply ad
02f0: 64 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22  d the keywords "
0300: 57 49 54 48 4f 55 54 20 52 4f 57 49 44 22 0a 74  WITHOUT ROWID".t
0310: 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65  o the end of the
0320: 20 5b 43 52 45 41 54 45 20 54 41 42 4c 45 5d 20   [CREATE TABLE] 
0330: 73 74 61 74 65 6d 65 6e 74 2e 20 20 46 6f 72 20  statement.  For 
0340: 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 3c 62  example:</p>..<b
0350: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a  lockquote><pre>.
0360: 43 52 45 41 54 45 20 54 41 42 4c 45 20 49 46 20  CREATE TABLE IF 
0370: 4e 4f 54 20 45 58 49 53 54 53 20 77 6f 72 64 63  NOT EXISTS wordc
0380: 6f 75 6e 74 28 0a 20 20 77 6f 72 64 20 54 45 58  ount(.  word TEX
0390: 54 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a 20  T PRIMARY KEY,. 
03a0: 20 63 6e 74 20 49 4e 54 45 47 45 52 0a 29 20 3c   cnt INTEGER.) <
03b0: 62 3e 57 49 54 48 4f 55 54 20 52 4f 57 49 44 3c  b>WITHOUT ROWID<
03c0: 2f 62 3e 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  /b>;.</pre></blo
03d0: 63 6b 71 75 6f 74 65 3e 29 5e 0a 0a 3c 70 3e 5e  ckquote>)^..<p>^
03e0: 28 41 73 20 77 69 74 68 20 61 6c 6c 20 53 51 4c  (As with all SQL
03f0: 20 73 79 6e 74 61 78 2c 20 74 68 65 20 63 61 73   syntax, the cas
0400: 65 20 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64  e of the keyword
0410: 73 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 74 65  s does not matte
0420: 72 2e 20 20 0a 4f 6e 65 20 63 61 6e 20 77 72 69  r.  .One can wri
0430: 74 65 20 22 57 49 54 48 4f 55 54 20 72 6f 77 69  te "WITHOUT rowi
0440: 64 22 20 6f 72 20 22 77 69 74 68 6f 75 74 20 72  d" or "without r
0450: 6f 77 69 64 22 20 6f 72 20 22 57 69 54 68 4f 75  owid" or "WiThOu
0460: 54 20 72 4f 77 49 64 22 20 61 6e 64 0a 69 74 20  T rOwId" and.it 
0470: 77 69 6c 6c 20 6d 65 61 6e 20 74 68 65 20 73 61  will mean the sa
0480: 6d 65 20 74 68 69 6e 67 2e 29 5e 3c 2f 70 3e 0a  me thing.)^</p>.
0490: 0a 3c 70 3e 45 76 65 72 79 20 57 49 54 48 4f 55  .<p>Every WITHOU
04a0: 54 20 52 4f 57 49 44 20 74 61 62 6c 65 20 6d 75  T ROWID table mu
04b0: 73 74 20 68 61 76 65 20 61 20 5b 50 52 49 4d 41  st have a [PRIMA
04c0: 52 59 20 4b 45 59 5d 2e 20 20 5e 41 6e 20 65 72  RY KEY].  ^An er
04d0: 72 6f 72 20 69 73 20 72 61 69 73 65 64 0a 69 66  ror is raised.if
04e0: 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45 20   a CREATE TABLE 
04f0: 73 74 61 74 65 6d 65 6e 74 20 77 69 74 68 20 74  statement with t
0500: 68 65 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44  he WITHOUT ROWID
0510: 20 63 6c 61 75 73 65 20 6c 61 63 6b 73 20 61 20   clause lacks a 
0520: 50 52 49 4d 41 52 59 20 4b 45 59 2e 0a 0a 3c 70  PRIMARY KEY...<p
0530: 3e 49 6e 20 6d 6f 73 74 20 63 6f 6e 74 65 78 74  >In most context
0540: 73 2c 20 74 68 65 20 73 70 65 63 69 61 6c 20 22  s, the special "
0550: 72 6f 77 69 64 22 20 63 6f 6c 75 6d 6e 20 6f 66  rowid" column of
0560: 20 6e 6f 72 6d 61 6c 20 74 61 62 6c 65 73 20 63   normal tables c
0570: 61 6e 20 0a 61 6c 73 6f 20 62 65 20 63 61 6c 6c  an .also be call
0580: 65 64 20 22 6f 69 64 22 20 6f 72 20 22 5f 72 6f  ed "oid" or "_ro
0590: 77 69 64 5f 22 2e 20 20 5e 48 6f 77 65 76 65 72  wid_".  ^However
05a0: 2c 20 6f 6e 6c 79 20 22 72 6f 77 69 64 22 20 77  , only "rowid" w
05b0: 6f 72 6b 73 20 61 73 20 0a 74 68 65 20 6b 65 79  orks as .the key
05c0: 77 6f 72 64 20 69 6e 20 74 68 65 20 43 52 45 41  word in the CREA
05d0: 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65  TE TABLE stateme
05e0: 6e 74 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 43 6f 6d  nt.</p>..<h2>Com
05f0: 70 61 74 69 62 69 6c 69 74 79 3c 2f 68 32 3e 0a  patibility</h2>.
0600: 0a 3c 70 3e 53 51 4c 69 74 65 20 5b 76 65 72 73  .<p>SQLite [vers
0610: 69 6f 6e 20 33 2e 38 2e 32 5d 20 28 5b 64 61 74  ion 3.8.2] ([dat
0620: 65 6f 66 3a 33 2e 38 2e 32 5d 29 20 6f 72 20 6c  eof:3.8.2]) or l
0630: 61 74 65 72 20 0a 69 73 20 6e 65 63 65 73 73 61  ater .is necessa
0640: 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 75  ry in order to u
0650: 73 65 20 61 20 57 49 54 48 4f 55 54 0a 52 4f 57  se a WITHOUT.ROW
0660: 49 44 20 74 61 62 6c 65 2e 20 20 41 6e 20 61 74  ID table.  An at
0670: 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 61 20  tempt to open a 
0680: 64 61 74 61 62 61 73 65 20 74 68 61 74 20 63 6f  database that co
0690: 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f  ntains one or mo
06a0: 72 65 20 57 49 54 48 4f 55 54 0a 52 4f 57 49 44  re WITHOUT.ROWID
06b0: 20 74 61 62 6c 65 73 20 75 73 69 6e 67 20 61 6e   tables using an
06c0: 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e   earlier version
06d0: 20 6f 66 20 53 51 4c 69 74 65 20 77 69 6c 6c 20   of SQLite will 
06e0: 72 65 73 75 6c 74 20 69 6e 20 61 0a 22 6d 61 6c  result in a."mal
06f0: 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20  formed database 
0700: 73 63 68 65 6d 61 22 20 65 72 72 6f 72 2e 3c 2f  schema" error.</
0710: 70 3e 0a 0a 3c 68 32 3e 51 75 69 72 6b 73 3c 2f  p>..<h2>Quirks</
0720: 68 32 3e 0a 0a 3c 70 3e 57 49 54 48 4f 55 54 20  h2>..<p>WITHOUT 
0730: 52 4f 57 49 44 20 69 73 20 66 6f 75 6e 64 20 6f  ROWID is found o
0740: 6e 6c 79 20 69 6e 20 53 51 4c 69 74 65 20 61 6e  nly in SQLite an
0750: 64 20 69 73 20 6e 6f 74 20 63 6f 6d 70 61 74 69  d is not compati
0760: 62 6c 65 0a 77 69 74 68 20 61 6e 79 20 6f 74 68  ble.with any oth
0770: 65 72 20 53 51 4c 20 64 61 74 61 62 61 73 65 20  er SQL database 
0780: 65 6e 67 69 6e 65 2c 20 61 73 20 66 61 72 20 61  engine, as far a
0790: 73 20 77 65 20 6b 6e 6f 77 2e 0a 49 6e 20 61 6e  s we know..In an
07a0: 20 65 6c 65 67 61 6e 74 20 73 79 73 74 65 6d 2c   elegant system,
07b0: 20 61 6c 6c 20 74 61 62 6c 65 73 20 77 6f 75 6c   all tables woul
07c0: 64 20 62 65 68 61 76 65 20 61 73 20 57 49 54 48  d behave as WITH
07d0: 4f 55 54 20 52 4f 57 49 44 0a 74 61 62 6c 65 73  OUT ROWID.tables
07e0: 20 65 76 65 6e 20 77 69 74 68 6f 75 74 20 74 68   even without th
07f0: 65 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20  e WITHOUT ROWID 
0800: 6b 65 79 77 6f 72 64 2e 20 20 48 6f 77 65 76 65  keyword.  Howeve
0810: 72 2c 20 77 68 65 6e 20 53 51 4c 69 74 65 20 77  r, when SQLite w
0820: 61 73 0a 66 69 72 73 74 20 64 65 73 69 67 6e 65  as.first designe
0830: 64 2c 20 69 74 20 75 73 65 64 20 6f 6e 6c 79 20  d, it used only 
0840: 69 6e 74 65 67 65 72 20 5b 72 6f 77 69 64 7c 72  integer [rowid|r
0850: 6f 77 69 64 73 5d 20 66 6f 72 20 72 6f 77 20 6b  owids] for row k
0860: 65 79 73 20 0a 74 6f 20 73 69 6d 70 6c 69 66 79  eys .to simplify
0870: 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   the implementat
0880: 69 6f 6e 2e 0a 54 68 69 73 20 61 70 70 72 6f 61  ion..This approa
0890: 63 68 20 77 6f 72 6b 65 64 20 77 65 6c 6c 20 66  ch worked well f
08a0: 6f 72 20 6d 61 6e 79 20 79 65 61 72 73 2e 20 20  or many years.  
08b0: 42 75 74 20 61 73 20 74 68 65 20 64 65 6d 61 6e  But as the deman
08c0: 64 73 20 6f 6e 0a 53 51 4c 69 74 65 20 67 72 65  ds on.SQLite gre
08d0: 77 2c 20 74 68 65 20 6e 65 65 64 20 66 6f 72 20  w, the need for 
08e0: 74 61 62 6c 65 73 20 69 6e 20 77 68 69 63 68 20  tables in which 
08f0: 74 68 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20  the PRIMARY KEY 
0900: 72 65 61 6c 6c 79 20 64 69 64 0a 63 6f 72 72 65  really did.corre
0910: 73 70 6f 6e 64 20 74 6f 20 74 68 65 20 75 6e 64  spond to the und
0920: 65 72 6c 79 69 6e 67 20 72 6f 77 20 6b 65 79 20  erlying row key 
0930: 67 72 65 77 20 6d 6f 72 65 20 61 63 75 74 65 2e  grew more acute.
0940: 20 20 54 68 65 20 57 49 54 48 4f 55 54 20 52 4f    The WITHOUT RO
0950: 57 49 44 0a 63 6f 6e 63 65 70 74 20 77 61 73 20  WID.concept was 
0960: 61 64 64 65 64 0a 69 6e 20 6f 72 64 65 72 20 74  added.in order t
0970: 6f 20 6d 65 65 74 20 74 68 61 74 20 6e 65 65 64  o meet that need
0980: 20 77 69 74 68 6f 75 74 20 62 72 65 61 6b 69 6e   without breakin
0990: 67 20 62 61 63 6b 77 61 72 64 73 0a 63 6f 6d 70  g backwards.comp
09a0: 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 74  atibility with t
09b0: 68 65 20 62 69 6c 6c 69 6f 6e 73 20 6f 66 20 53  he billions of S
09c0: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 73 20  QLite databases 
09d0: 61 6c 72 65 61 64 79 20 69 6e 20 75 73 65 20 61  already in use a
09e0: 74 0a 74 68 65 20 74 69 6d 65 20 28 63 69 72 63  t.the time (circ
09f0: 61 20 32 30 31 33 29 2e 0a 0a 3c 68 31 3e 44 69  a 2013)...<h1>Di
0a00: 66 66 65 72 65 6e 63 65 73 20 46 72 6f 6d 20 4f  fferences From O
0a10: 72 64 69 6e 61 72 79 20 52 6f 77 69 64 20 54 61  rdinary Rowid Ta
0a20: 62 6c 65 73 3c 2f 68 31 3e 0a 0a 3c 70 3e 54 68  bles</h1>..<p>Th
0a30: 65 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20  e WITHOUT ROWID 
0a40: 73 79 6e 74 61 78 20 69 73 20 61 6e 20 6f 70 74  syntax is an opt
0a50: 69 6d 69 7a 61 74 69 6f 6e 2e 20 20 49 74 20 70  imization.  It p
0a60: 72 6f 76 69 64 65 73 20 6e 6f 20 6e 65 77 0a 63  rovides no new.c
0a70: 61 70 61 62 69 6c 69 74 69 65 73 2e 20 20 41 6e  apabilities.  An
0a80: 79 74 68 69 6e 67 20 74 68 61 74 20 63 61 6e 20  ything that can 
0a90: 62 65 20 64 6f 6e 65 20 75 73 69 6e 67 20 61 20  be done using a 
0aa0: 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74 61  WITHOUT ROWID ta
0ab0: 62 6c 65 0a 63 61 6e 20 61 6c 73 6f 20 62 65 20  ble.can also be 
0ac0: 64 6f 6e 65 20 69 6e 20 65 78 61 63 74 6c 79 20  done in exactly 
0ad0: 74 68 65 20 73 61 6d 65 20 77 61 79 2c 20 61 6e  the same way, an
0ae0: 64 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 61  d exactly the sa
0af0: 6d 65 20 73 79 6e 74 61 78 2c 0a 75 73 69 6e 67  me syntax,.using
0b00: 20 61 6e 20 6f 72 64 69 6e 61 72 79 20 72 6f 77   an ordinary row
0b10: 69 64 20 74 61 62 6c 65 2e 20 20 54 68 65 20 6f  id table.  The o
0b20: 6e 6c 79 20 61 64 76 61 6e 74 61 67 65 20 6f 66  nly advantage of
0b30: 20 61 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44   a WITHOUT ROWID
0b40: 0a 74 61 62 6c 65 20 69 73 20 74 68 61 74 20 69  .table is that i
0b50: 74 20 63 61 6e 20 73 6f 6d 65 74 69 6d 65 73 20  t can sometimes 
0b60: 75 73 65 20 6c 65 73 73 20 64 69 73 6b 20 73 70  use less disk sp
0b70: 61 63 65 20 61 6e 64 2f 6f 72 20 70 65 72 66 6f  ace and/or perfo
0b80: 72 6d 20 61 20 6c 69 74 74 6c 65 0a 66 61 73 74  rm a little.fast
0b90: 65 72 20 74 68 61 6e 20 61 6e 20 6f 72 64 69 6e  er than an ordin
0ba0: 61 72 79 20 72 6f 77 69 64 20 74 61 62 6c 65 2e  ary rowid table.
0bb0: 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 72 20 74 68 65  </p>..<p>For the
0bc0: 20 6d 6f 73 74 20 70 61 72 74 2c 20 6f 72 64 69   most part, ordi
0bd0: 6e 61 72 79 20 72 6f 77 69 64 20 74 61 62 6c 65  nary rowid table
0be0: 73 20 61 6e 64 20 57 49 54 48 4f 55 54 20 52 4f  s and WITHOUT RO
0bf0: 57 49 44 20 74 61 62 6c 65 73 0a 61 72 65 20 69  WID tables.are i
0c00: 6e 74 65 72 63 68 61 6e 67 65 61 62 6c 65 2e 20  nterchangeable. 
0c10: 20 42 75 74 20 74 68 65 72 65 20 61 72 65 20 73   But there are s
0c20: 6f 6d 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 72  ome additional r
0c30: 65 73 74 72 69 63 74 69 6f 6e 73 20 6f 6e 0a 57  estrictions on.W
0c40: 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74 61 62  ITHOUT ROWID tab
0c50: 6c 65 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20  les that do not 
0c60: 61 70 70 6c 79 20 74 6f 20 6f 72 64 69 6e 61 72  apply to ordinar
0c70: 79 20 72 6f 77 69 64 20 74 61 62 6c 65 73 3a 3c  y rowid tables:<
0c80: 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70  /p>..<ol>.<li><p
0c90: 3e 0a 3c 62 3e 5e 45 76 65 72 79 20 57 49 54 48  >.<b>^Every WITH
0ca0: 4f 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 20  OUT ROWID table 
0cb0: 6d 75 73 74 20 68 61 76 65 20 61 20 50 52 49 4d  must have a PRIM
0cc0: 41 52 59 20 4b 45 59 2e 3c 2f 62 3e 0a 5e 41 6e  ARY KEY.</b>.^An
0cd0: 20 61 74 74 65 6d 70 74 20 74 6f 20 63 72 65 61   attempt to crea
0ce0: 74 65 20 61 20 57 49 54 48 4f 55 54 20 52 4f 57  te a WITHOUT ROW
0cf0: 49 44 20 74 61 62 6c 65 20 77 69 74 68 6f 75 74  ID table without
0d00: 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20 72   a PRIMARY KEY r
0d10: 65 73 75 6c 74 73 0a 69 6e 20 61 6e 20 65 72 72  esults.in an err
0d20: 6f 72 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 3c 62 3e  or...<li><p>.<b>
0d30: 5e 54 68 65 20 73 70 65 63 69 61 6c 20 62 65 68  ^The special beh
0d40: 61 76 69 6f 72 73 20 61 73 73 6f 63 69 61 74 65  aviors associate
0d50: 64 20 22 5b 49 4e 54 45 47 45 52 20 50 52 49 4d  d "[INTEGER PRIM
0d60: 41 52 59 20 4b 45 59 5d 22 20 64 6f 20 6e 6f 74  ARY KEY]" do not
0d70: 20 61 70 70 6c 79 0a 6f 6e 20 57 49 54 48 4f 55   apply.on WITHOU
0d80: 54 20 52 4f 57 49 44 20 74 61 62 6c 65 73 2e 3c  T ROWID tables.<
0d90: 2f 62 3e 0a 49 6e 20 61 6e 20 6f 72 64 69 6e 61  /b>.In an ordina
0da0: 72 79 20 74 61 62 6c 65 2c 20 22 49 4e 54 45 47  ry table, "INTEG
0db0: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 22 20  ER PRIMARY KEY" 
0dc0: 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 63  means that the c
0dd0: 6f 6c 75 6d 6e 20 69 73 20 61 6e 0a 61 6c 69 61  olumn is an.alia
0de0: 73 20 66 6f 72 20 74 68 65 20 72 6f 77 69 64 2e  s for the rowid.
0df0: 20 20 42 75 74 20 73 69 6e 63 65 20 74 68 65 72    But since ther
0e00: 65 20 69 73 20 6e 6f 20 72 6f 77 69 64 20 69 6e  e is no rowid in
0e10: 20 61 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44   a WITHOUT ROWID
0e20: 0a 74 61 62 6c 65 2c 20 74 68 61 74 20 73 70 65  .table, that spe
0e30: 63 69 61 6c 20 6d 65 61 6e 69 6e 67 20 6e 6f 20  cial meaning no 
0e40: 6c 6f 6e 67 65 72 20 61 70 70 6c 69 65 73 2e 20  longer applies. 
0e50: 20 41 6e 20 22 49 4e 54 45 47 45 52 20 50 52 49   An "INTEGER PRI
0e60: 4d 41 52 59 20 4b 45 59 22 20 0a 63 6f 6c 75 6d  MARY KEY" .colum
0e70: 6e 20 69 6e 20 61 20 57 49 54 48 4f 55 54 20 52  n in a WITHOUT R
0e80: 4f 57 49 44 20 74 61 62 6c 65 20 77 6f 72 6b 73  OWID table works
0e90: 0a 6c 69 6b 65 20 61 6e 20 22 49 4e 54 20 50 52  .like an "INT PR
0ea0: 49 4d 41 52 59 20 4b 45 59 22 20 63 6f 6c 75 6d  IMARY KEY" colum
0eb0: 6e 20 69 6e 20 61 6e 20 6f 72 64 69 6e 61 72 79  n in an ordinary
0ec0: 20 74 61 62 6c 65 3a 20 49 74 20 69 73 20 61 20   table: It is a 
0ed0: 50 52 49 4d 41 52 59 20 4b 45 59 0a 74 68 61 74  PRIMARY KEY.that
0ee0: 20 68 61 73 20 69 6e 74 65 67 65 72 20 5b 61 66   has integer [af
0ef0: 66 69 6e 69 74 79 5d 2e 0a 0a 3c 6c 69 3e 3c 70  finity]...<li><p
0f00: 3e 0a 3c 62 3e 5e 5b 41 55 54 4f 49 4e 43 52 45  >.<b>^[AUTOINCRE
0f10: 4d 45 4e 54 5d 20 64 6f 65 73 20 6e 6f 74 20 77  MENT] does not w
0f20: 6f 72 6b 20 6f 6e 20 57 49 54 48 4f 55 54 20 52  ork on WITHOUT R
0f30: 4f 57 49 44 20 74 61 62 6c 65 73 2e 3c 2f 62 3e  OWID tables.</b>
0f40: 0a 54 68 65 20 5b 41 55 54 4f 49 4e 43 52 45 4d  .The [AUTOINCREM
0f50: 45 4e 54 5d 20 6d 65 63 68 61 6e 69 73 6d 20 61  ENT] mechanism a
0f60: 73 73 75 6d 65 73 20 74 68 65 20 70 72 65 73 65  ssumes the prese
0f70: 6e 63 65 20 6f 66 20 61 20 72 6f 77 69 64 20 61  nce of a rowid a
0f80: 6e 64 20 73 6f 20 69 74 0a 64 6f 65 73 20 6e 6f  nd so it.does no
0f90: 74 20 77 6f 72 6b 20 6f 6e 20 61 20 57 49 54 48  t work on a WITH
0fa0: 4f 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 2e  OUT ROWID table.
0fb0: 20 20 5e 41 6e 20 65 72 72 6f 72 20 69 73 20 72    ^An error is r
0fc0: 61 69 73 65 64 20 69 66 20 74 68 65 0a 20 22 41  aised if the. "A
0fd0: 55 54 4f 49 4e 43 52 45 4d 45 4e 54 22 20 6b 65  UTOINCREMENT" ke
0fe0: 79 77 6f 72 64 20 69 73 20 75 73 65 64 20 69 6e  yword is used in
0ff0: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
1000: 45 20 73 74 61 74 65 6d 65 6e 74 20 66 6f 72 0a  E statement for.
1010: 61 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20  a WITHOUT ROWID 
1020: 74 61 62 6c 65 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a  table...<li><p>.
1030: 3c 62 3e 5e 4e 4f 54 20 4e 55 4c 4c 20 69 73 20  <b>^NOT NULL is 
1040: 65 6e 66 6f 72 63 65 64 20 6f 6e 20 65 76 65 72  enforced on ever
1050: 79 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20  y column of the 
1060: 50 52 49 4d 41 52 59 20 4b 45 59 20 69 6e 20 61  PRIMARY KEY in a
1070: 20 57 49 54 48 4f 55 54 0a 52 4f 57 49 44 20 74   WITHOUT.ROWID t
1080: 61 62 6c 65 2e 3c 2f 62 3e 0a 54 68 69 73 20 69  able.</b>.This i
1090: 73 20 69 6e 20 61 63 63 6f 72 64 61 6e 63 65 20  s in accordance 
10a0: 77 69 74 68 20 74 68 65 20 53 51 4c 20 73 74 61  with the SQL sta
10b0: 6e 64 61 72 64 2e 20 20 45 61 63 68 20 63 6f 6c  ndard.  Each col
10c0: 75 6d 6e 20 6f 66 20 61 20 50 52 49 4d 41 52 59  umn of a PRIMARY
10d0: 20 4b 45 59 0a 69 73 20 73 75 70 70 6f 73 65 64   KEY.is supposed
10e0: 20 74 6f 20 62 65 20 69 6e 64 69 76 69 64 75 61   to be individua
10f0: 6c 6c 79 20 4e 4f 54 20 4e 55 4c 4c 2e 20 20 48  lly NOT NULL.  H
1100: 6f 77 65 76 65 72 2c 20 4e 4f 54 20 4e 55 4c 4c  owever, NOT NULL
1110: 20 77 61 73 20 6e 6f 74 20 65 6e 66 6f 72 63 65   was not enforce
1120: 64 0a 6f 6e 20 50 52 49 4d 41 52 59 20 4b 45 59  d.on PRIMARY KEY
1130: 20 63 6f 6c 75 6d 6e 73 20 62 79 20 65 61 72 6c   columns by earl
1140: 79 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51  y versions of SQ
1150: 4c 69 74 65 20 64 75 65 20 74 6f 20 61 20 62 75  Lite due to a bu
1160: 67 2e 20 20 42 79 20 74 68 65 0a 74 69 6d 65 20  g.  By the.time 
1170: 74 68 61 74 20 74 68 69 73 20 62 75 67 20 77 61  that this bug wa
1180: 73 20 64 69 73 63 6f 76 65 72 65 64 2c 20 73 6f  s discovered, so
1190: 20 6d 61 6e 79 20 53 51 4c 69 74 65 20 64 61 74   many SQLite dat
11a0: 61 62 61 73 65 73 20 77 65 72 65 20 61 6c 72 65  abases were alre
11b0: 61 64 79 0a 69 6e 20 63 69 72 63 75 6c 61 74 69  ady.in circulati
11c0: 6f 6e 20 74 68 61 74 20 74 68 65 20 64 65 63 69  on that the deci
11d0: 73 69 6f 6e 20 77 61 73 20 6d 61 64 65 20 6e 6f  sion was made no
11e0: 74 20 74 6f 20 66 69 78 20 74 68 69 73 20 62 75  t to fix this bu
11f0: 67 20 66 6f 72 20 66 65 61 72 20 6f 66 0a 62 72  g for fear of.br
1200: 65 61 6b 69 6e 67 20 63 6f 6d 70 61 74 69 62 69  eaking compatibi
1210: 6c 69 74 79 2e 20 20 5e 53 6f 2c 20 6f 72 64 69  lity.  ^So, ordi
1220: 6e 61 72 79 20 72 6f 77 69 64 20 74 61 62 6c 65  nary rowid table
1230: 73 20 69 6e 20 53 51 4c 69 74 65 20 76 69 6f 6c  s in SQLite viol
1240: 61 74 65 20 74 68 65 0a 53 51 4c 20 73 74 61 6e  ate the.SQL stan
1250: 64 61 72 64 20 61 6e 64 20 61 6c 6c 6f 77 20 4e  dard and allow N
1260: 55 4c 4c 20 76 61 6c 75 65 73 20 69 6e 20 50 52  ULL values in PR
1270: 49 4d 41 52 59 20 4b 45 59 20 66 69 65 6c 64 73  IMARY KEY fields
1280: 2e 20 20 5e 42 75 74 20 57 49 54 48 4f 55 54 20  .  ^But WITHOUT 
1290: 52 4f 57 49 44 0a 74 61 62 6c 65 73 20 64 6f 20  ROWID.tables do 
12a0: 66 6f 6c 6c 6f 77 20 74 68 65 20 73 74 61 6e 64  follow the stand
12b0: 61 72 64 20 61 6e 64 20 77 69 6c 6c 20 74 68 72  ard and will thr
12c0: 6f 77 20 61 6e 20 65 72 72 6f 72 20 6f 6e 20 61  ow an error on a
12d0: 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 0a 69 6e  ny attempt to.in
12e0: 73 65 72 74 20 61 20 4e 55 4c 4c 20 69 6e 74 6f  sert a NULL into
12f0: 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63   a PRIMARY KEY c
1300: 6f 6c 75 6d 6e 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a  olumn...<li><p>.
1310: 3c 62 3e 5e 54 68 65 20 5b 73 71 6c 69 74 65 33  <b>^The [sqlite3
1320: 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77  _last_insert_row
1330: 69 64 28 29 5d 20 66 75 6e 63 74 69 6f 6e 0a 64  id()] function.d
1340: 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 66 6f 72  oes not work for
1350: 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74   WITHOUT ROWID t
1360: 61 62 6c 65 73 2e 3c 2f 62 3e 0a 49 6e 73 65 72  ables.</b>.Inser
1370: 74 73 20 69 6e 74 6f 20 61 20 57 49 54 48 4f 55  ts into a WITHOU
1380: 54 20 52 4f 57 49 44 20 64 6f 20 6e 6f 74 20 63  T ROWID do not c
1390: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20  hange the value 
13a0: 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 0a  returned by the.
13b0: 5b 73 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e  [sqlite3_last_in
13c0: 73 65 72 74 5f 72 6f 77 69 64 28 29 5d 20 66 75  sert_rowid()] fu
13d0: 6e 63 74 69 6f 6e 2e 20 20 54 68 65 20 5b 6c 61  nction.  The [la
13e0: 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28  st_insert_rowid(
13f0: 29 5d 20 53 51 4c 0a 66 75 6e 63 74 69 6f 6e 20  )] SQL.function 
1400: 69 73 20 61 6c 73 6f 20 75 6e 61 66 66 65 63 74  is also unaffect
1410: 65 64 20 73 69 6e 63 65 20 69 74 20 69 73 20 6a  ed since it is j
1420: 75 73 74 20 61 20 77 72 61 70 70 65 72 20 61 72  ust a wrapper ar
1430: 6f 75 6e 64 0a 5b 73 71 6c 69 74 65 33 5f 6c 61  ound.[sqlite3_la
1440: 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28  st_insert_rowid(
1450: 29 5d 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 3c 62 3e  )]...<li><p>.<b>
1460: 5e 54 68 65 20 5b 73 71 6c 69 74 65 33 5f 62 6c  ^The [sqlite3_bl
1470: 6f 62 5f 6f 70 65 6e 20 7c 20 69 6e 63 72 65 6d  ob_open | increm
1480: 65 6e 74 61 6c 20 62 6c 6f 62 20 49 2f 4f 5d 20  ental blob I/O] 
1490: 6d 65 63 68 61 6e 69 73 6d 20 64 6f 65 73 20 6e  mechanism does n
14a0: 6f 74 20 77 6f 72 6b 0a 66 6f 72 20 57 49 54 48  ot work.for WITH
14b0: 4f 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 73  OUT ROWID tables
14c0: 2e 3c 2f 62 3e 0a 49 6e 63 72 65 6d 65 6e 74 61  .</b>.Incrementa
14d0: 6c 20 42 4c 4f 42 20 49 2f 4f 20 75 73 65 73 20  l BLOB I/O uses 
14e0: 74 68 65 20 72 6f 77 69 64 20 74 6f 20 63 72 65  the rowid to cre
14f0: 61 74 65 20 61 6e 20 5b 73 71 6c 69 74 65 33 5f  ate an [sqlite3_
1500: 62 6c 6f 62 5d 20 6f 62 6a 65 63 74 20 66 6f 72  blob] object for
1510: 0a 64 6f 69 6e 67 20 74 68 65 20 64 69 72 65 63  .doing the direc
1520: 74 20 49 2f 4f 2e 20 20 48 6f 77 65 76 65 72 2c  t I/O.  However,
1530: 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74   WITHOUT ROWID t
1540: 61 62 6c 65 73 20 64 6f 20 6e 6f 74 20 68 61 76  ables do not hav
1550: 65 20 61 20 72 6f 77 69 64 2c 0a 61 6e 64 20 73  e a rowid,.and s
1560: 6f 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61  o there is no wa
1570: 79 20 74 6f 20 63 72 65 61 74 65 20 61 6e 20 5b  y to create an [
1580: 73 71 6c 69 74 65 33 5f 62 6c 6f 62 5d 20 6f 62  sqlite3_blob] ob
1590: 6a 65 63 74 20 66 6f 72 20 61 20 57 49 54 48 4f  ject for a WITHO
15a0: 55 54 0a 52 4f 57 49 44 20 74 61 62 6c 65 2e 0a  UT.ROWID table..
15b0: 0a 3c 6c 69 3e 3c 70 3e 0a 3c 62 3e 5e 54 68 65  .<li><p>.<b>^The
15c0: 20 5b 73 71 6c 69 74 65 33 5f 75 70 64 61 74 65   [sqlite3_update
15d0: 5f 68 6f 6f 6b 28 29 5d 20 69 6e 74 65 72 66 61  _hook()] interfa
15e0: 63 65 20 64 6f 65 73 20 6e 6f 74 20 66 69 72 65  ce does not fire
15f0: 20 63 61 6c 6c 62 61 63 6b 73 20 66 6f 72 20 63   callbacks for c
1600: 68 61 6e 67 65 73 0a 74 6f 20 61 20 57 49 54 48  hanges.to a WITH
1610: 4f 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 2e  OUT ROWID table.
1620: 3c 2f 62 3e 0a 50 61 72 74 20 6f 66 20 74 68 65  </b>.Part of the
1630: 20 63 61 6c 6c 62 61 63 6b 20 66 72 6f 6d 20 5b   callback from [
1640: 73 71 6c 69 74 65 33 5f 75 70 64 61 74 65 5f 68  sqlite3_update_h
1650: 6f 6f 6b 28 29 5d 20 69 73 20 74 68 65 20 72 6f  ook()] is the ro
1660: 77 69 64 20 6f 66 20 74 68 65 20 74 61 62 6c 65  wid of the table
1670: 0a 72 6f 77 20 74 68 61 74 20 68 61 73 20 63 68  .row that has ch
1680: 61 6e 67 65 64 2e 20 20 48 6f 77 65 76 65 72 2c  anged.  However,
1690: 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74   WITHOUT ROWID t
16a0: 61 62 6c 65 73 20 64 6f 20 6e 6f 74 20 68 61 76  ables do not hav
16b0: 65 20 61 20 72 6f 77 69 64 2e 0a 48 65 6e 63 65  e a rowid..Hence
16c0: 2c 20 74 68 65 20 75 70 64 61 74 65 20 68 6f 6f  , the update hoo
16d0: 6b 20 69 73 20 6e 6f 74 20 69 6e 76 6f 6b 65 64  k is not invoked
16e0: 20 77 68 65 6e 20 61 20 57 49 54 48 4f 55 54 20   when a WITHOUT 
16f0: 52 4f 57 49 44 20 74 61 62 6c 65 20 63 68 61 6e  ROWID table chan
1700: 67 65 73 2e 0a 3c 70 3e 4e 6f 74 65 20 74 68 61  ges..<p>Note tha
1710: 74 20 73 69 6e 63 65 20 74 68 65 20 5b 73 65 73  t since the [ses
1720: 73 69 6f 6e 5d 20 65 78 74 65 6e 73 69 6f 6e 20  sion] extension 
1730: 75 73 65 73 20 74 68 65 20 75 70 64 61 74 65 20  uses the update 
1740: 68 6f 6f 6b 2c 20 74 68 61 74 20 6d 65 61 6e 73  hook, that means
1750: 0a 74 68 61 74 20 74 68 65 20 73 65 73 73 69 6f  .that the sessio
1760: 6e 20 65 78 74 65 6e 73 69 6f 6e 20 77 69 6c 6c  n extension will
1770: 20 6e 6f 74 20 77 6f 72 6b 20 63 6f 72 72 65 63   not work correc
1780: 74 6c 79 20 6f 6e 20 61 20 64 61 74 61 62 61 73  tly on a databas
1790: 65 20 74 68 61 74 20 69 6e 63 6c 75 64 65 73 0a  e that includes.
17a0: 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74 61  WITHOUT ROWID ta
17b0: 62 6c 65 73 2e 0a 3c 2f 6f 6c 3e 0a 0a 3c 74 63  bles..</ol>..<tc
17c0: 6c 3e 68 64 5f 66 72 61 67 6d 65 6e 74 20 62 65  l>hd_fragment be
17d0: 6e 65 20 7b 62 65 6e 65 66 69 74 73 20 6f 66 20  ne {benefits of 
17e0: 75 73 69 6e 67 20 57 49 54 48 4f 55 54 20 52 4f  using WITHOUT RO
17f0: 57 49 44 7d 3c 2f 74 63 6c 3e 0a 3c 68 31 3e 42  WID}</tcl>.<h1>B
1800: 65 6e 65 66 69 74 73 20 4f 66 20 57 49 54 48 4f  enefits Of WITHO
1810: 55 54 20 52 4f 57 49 44 20 54 61 62 6c 65 73 3c  UT ROWID Tables<
1820: 2f 68 31 3e 0a 0a 3c 70 3e 41 20 57 49 54 48 4f  /h1>..<p>A WITHO
1830: 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 20 69  UT ROWID table i
1840: 73 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f  s an optimizatio
1850: 6e 20 74 68 61 74 20 63 61 6e 20 72 65 64 75 63  n that can reduc
1860: 65 20 73 74 6f 72 61 67 65 20 61 6e 64 0a 70 72  e storage and.pr
1870: 6f 63 65 73 73 69 6e 67 20 72 65 71 75 69 72 65  ocessing require
1880: 6d 65 6e 74 73 2e 0a 0a 3c 70 3e 49 6e 20 61 6e  ments...<p>In an
1890: 20 6f 72 64 69 6e 61 72 79 20 53 51 4c 69 74 65   ordinary SQLite
18a0: 20 74 61 62 6c 65 2c 20 74 68 65 20 50 52 49 4d   table, the PRIM
18b0: 41 52 59 20 4b 45 59 20 69 73 20 72 65 61 6c 6c  ARY KEY is reall
18c0: 79 20 6a 75 73 74 20 61 20 0a 5b 55 4e 49 51 55  y just a .[UNIQU
18d0: 45 5d 20 69 6e 64 65 78 2e 20 20 54 68 65 20 6b  E] index.  The k
18e0: 65 79 20 75 73 65 64 20 74 6f 20 6c 6f 6f 6b 20  ey used to look 
18f0: 75 70 20 72 65 63 6f 72 64 73 20 6f 6e 20 64 69  up records on di
1900: 73 6b 0a 69 73 20 74 68 65 20 5b 72 6f 77 69 64  sk.is the [rowid
1910: 5d 2e 0a 54 68 65 20 73 70 65 63 69 61 6c 20 22  ]..The special "
1920: 5b 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59  [INTEGER PRIMARY
1930: 20 4b 45 59 5d 22 20 63 6f 6c 75 6d 6e 20 74 79   KEY]" column ty
1940: 70 65 20 69 6e 20 6f 72 64 69 6e 61 72 79 20 53  pe in ordinary S
1950: 51 4c 69 74 65 20 74 61 62 6c 65 73 20 0a 63 61  QLite tables .ca
1960: 75 73 65 73 20 74 68 65 20 63 6f 6c 75 6d 6e 20  uses the column 
1970: 74 6f 20 62 65 20 61 6e 20 61 6c 69 61 73 20 66  to be an alias f
1980: 6f 72 20 74 68 65 20 72 6f 77 69 64 2c 20 61 6e  or the rowid, an
1990: 64 20 73 6f 20 61 6e 20 49 4e 54 45 47 45 52 20  d so an INTEGER 
19a0: 50 52 49 4d 41 52 59 0a 4b 45 59 20 69 73 20 61  PRIMARY.KEY is a
19b0: 20 74 72 75 65 20 50 52 49 4d 41 52 59 20 4b 45   true PRIMARY KE
19c0: 59 2e 20 20 42 75 74 20 61 6e 79 20 6f 74 68 65  Y.  But any othe
19d0: 72 20 6b 69 6e 64 20 6f 66 20 50 52 49 4d 41 52  r kind of PRIMAR
19e0: 59 20 4b 45 59 73 2c 20 69 6e 63 6c 75 64 69 6e  Y KEYs, includin
19f0: 67 0a 22 49 4e 54 20 50 52 49 4d 41 52 59 20 4b  g."INT PRIMARY K
1a00: 45 59 22 20 61 72 65 20 6a 75 73 74 20 75 6e 69  EY" are just uni
1a10: 71 75 65 20 69 6e 64 65 78 65 73 20 69 6e 20 61  que indexes in a
1a20: 6e 20 6f 72 64 69 6e 61 72 79 20 72 6f 77 69 64  n ordinary rowid
1a30: 20 74 61 62 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e   table.</p>..<p>
1a40: 43 6f 6e 73 69 64 65 72 20 61 20 74 61 62 6c 65  Consider a table
1a50: 20 28 73 68 6f 77 6e 20 62 65 6c 6f 77 29 20 69   (shown below) i
1a60: 6e 74 65 6e 64 65 64 20 74 6f 20 73 74 6f 72 65  ntended to store
1a70: 20 61 0a 76 6f 63 61 62 75 6c 61 72 79 20 6f 66   a.vocabulary of
1a80: 20 77 6f 72 64 73 20 74 6f 67 65 74 68 65 72 20   words together 
1a90: 77 69 74 68 20 61 20 63 6f 75 6e 74 20 6f 66 20  with a count of 
1aa0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6f 63  the number of oc
1ab0: 63 75 72 72 65 6e 63 65 73 20 6f 66 0a 65 61 63  currences of.eac
1ac0: 68 20 77 6f 72 64 20 69 6e 20 73 6f 6d 65 20 74  h word in some t
1ad0: 65 78 74 20 63 6f 72 70 75 73 3a 0a 0a 3c 62 6c  ext corpus:..<bl
1ae0: 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 43  ockquote><pre>.C
1af0: 52 45 41 54 45 20 54 41 42 4c 45 20 49 46 20 4e  REATE TABLE IF N
1b00: 4f 54 20 45 58 49 53 54 53 20 77 6f 72 64 63 6f  OT EXISTS wordco
1b10: 75 6e 74 28 0a 20 20 77 6f 72 64 20 54 45 58 54  unt(.  word TEXT
1b20: 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a 20 20   PRIMARY KEY,.  
1b30: 63 6e 74 20 49 4e 54 45 47 45 52 0a 29 3b 0a 3c  cnt INTEGER.);.<
1b40: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
1b50: 65 3e 0a 0a 3c 70 3e 41 73 20 61 6e 20 6f 72 64  e>..<p>As an ord
1b60: 69 6e 61 72 79 20 53 51 4c 69 74 65 20 74 61 62  inary SQLite tab
1b70: 6c 65 2c 20 22 77 6f 72 64 63 6f 75 6e 74 22 20  le, "wordcount" 
1b80: 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61  is implemented a
1b90: 73 20 74 77 6f 0a 73 65 70 61 72 61 74 65 20 42  s two.separate B
1ba0: 2d 54 72 65 65 73 2e 20 20 54 68 65 20 6d 61 69  -Trees.  The mai
1bb0: 6e 20 74 61 62 6c 65 20 75 73 65 73 20 74 68 65  n table uses the
1bc0: 20 68 69 64 64 65 6e 20 72 6f 77 69 64 20 76 61   hidden rowid va
1bd0: 6c 75 65 20 61 73 20 74 68 65 20 6b 65 79 0a 61  lue as the key.a
1be0: 6e 64 20 73 74 6f 72 65 73 20 74 68 65 20 22 77  nd stores the "w
1bf0: 6f 72 64 22 20 61 6e 64 20 22 63 6e 74 22 20 63  ord" and "cnt" c
1c00: 6f 6c 75 6d 6e 73 20 61 73 20 64 61 74 61 2e 20  olumns as data. 
1c10: 20 54 68 65 20 22 54 45 58 54 20 50 52 49 4d 41   The "TEXT PRIMA
1c20: 52 59 20 4b 45 59 22 0a 70 68 72 61 73 65 20 6f  RY KEY".phrase o
1c30: 66 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42  f the CREATE TAB
1c40: 4c 45 20 73 74 61 74 65 6d 65 6e 74 0a 63 61 75  LE statement.cau
1c50: 73 65 73 20 74 68 65 20 63 72 65 61 74 69 6f 6e  ses the creation
1c60: 20 6f 66 20 61 6e 20 5b 75 6e 69 71 75 65 20 69   of an [unique i
1c70: 6e 64 65 78 5d 20 6f 6e 20 74 68 65 20 22 77 6f  ndex] on the "wo
1c80: 72 64 22 20 63 6f 6c 75 6d 6e 2e 20 20 54 68 69  rd" column.  Thi
1c90: 73 20 69 6e 64 65 78 20 69 73 20 61 0a 73 65 70  s index is a.sep
1ca0: 61 72 61 74 65 20 42 2d 54 72 65 65 20 74 68 61  arate B-Tree tha
1cb0: 74 20 75 73 65 73 20 22 77 6f 72 64 22 20 61 6e  t uses "word" an
1cc0: 64 20 74 68 65 20 22 72 6f 77 69 64 22 20 61 73  d the "rowid" as
1cd0: 20 74 68 65 20 6b 65 79 20 61 6e 64 20 73 74 6f   the key and sto
1ce0: 72 65 73 20 6e 6f 0a 64 61 74 61 20 61 74 20 61  res no.data at a
1cf0: 6c 6c 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 74  ll.  Note that t
1d00: 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74  he complete text
1d10: 20 6f 66 20 65 76 65 72 79 20 22 77 6f 72 64 22   of every "word"
1d20: 20 69 73 20 73 74 6f 72 65 64 20 74 77 69 63 65   is stored twice
1d30: 3a 0a 6f 6e 63 65 20 69 6e 20 74 68 65 20 6d 61  :.once in the ma
1d40: 69 6e 20 74 61 62 6c 65 20 61 6e 64 20 61 67 61  in table and aga
1d50: 69 6e 20 69 6e 20 74 68 65 20 69 6e 64 65 78 2e  in in the index.
1d60: 0a 0a 3c 70 3e 43 6f 6e 73 69 64 65 72 20 71 75  ..<p>Consider qu
1d70: 65 72 79 69 6e 67 20 74 68 69 73 20 74 61 62 6c  erying this tabl
1d80: 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6e 75  e to find the nu
1d90: 6d 62 65 72 20 6f 66 20 6f 63 63 75 72 72 65 6e  mber of occurren
1da0: 63 65 73 20 6f 66 20 74 68 65 0a 77 6f 72 64 20  ces of the.word 
1db0: 22 78 79 7a 7a 79 22 2e 3a 0a 0a 3c 62 6c 6f 63  "xyzzy".:..<bloc
1dc0: 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 53 45 4c  kquote><pre>.SEL
1dd0: 45 43 54 20 63 6e 74 20 46 52 4f 4d 20 77 6f 72  ECT cnt FROM wor
1de0: 64 63 6f 75 6e 74 20 57 48 45 52 45 20 77 6f 72  dcount WHERE wor
1df0: 64 3d 27 78 79 7a 7a 79 27 3b 0a 3c 2f 70 72 65  d='xyzzy';.</pre
1e00: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  ></blockquote>..
1e10: 3c 70 3e 54 68 69 73 20 71 75 65 72 79 20 66 69  <p>This query fi
1e20: 72 73 74 20 68 61 73 20 74 6f 20 73 65 61 72 63  rst has to searc
1e30: 68 20 74 68 65 20 69 6e 64 65 78 20 42 2d 54 72  h the index B-Tr
1e40: 65 65 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 61  ee looking for a
1e50: 6e 79 20 65 6e 74 72 79 0a 74 68 61 74 20 63 6f  ny entry.that co
1e60: 6e 74 61 69 6e 73 20 74 68 65 20 6d 61 74 63 68  ntains the match
1e70: 69 6e 67 20 76 61 6c 75 65 20 66 6f 72 20 22 77  ing value for "w
1e80: 6f 72 64 22 2e 20 20 57 68 65 6e 20 61 6e 20 65  ord".  When an e
1e90: 6e 74 72 79 20 69 73 20 66 6f 75 6e 64 20 69 6e  ntry is found in
1ea0: 0a 74 68 65 20 69 6e 64 65 78 2c 20 74 68 65 20  .the index, the 
1eb0: 72 6f 77 69 64 20 69 73 20 65 78 74 72 61 63 74  rowid is extract
1ec0: 65 64 20 61 6e 64 20 75 73 65 64 20 74 6f 20 73  ed and used to s
1ed0: 65 61 72 63 68 20 74 68 65 20 6d 61 69 6e 20 74  earch the main t
1ee0: 61 62 6c 65 2e 0a 54 68 65 6e 20 74 68 65 20 22  able..Then the "
1ef0: 63 6e 74 22 20 76 61 6c 75 65 20 69 73 20 72 65  cnt" value is re
1f00: 61 64 20 6f 75 74 20 6f 66 20 74 68 65 20 6d 61  ad out of the ma
1f10: 69 6e 20 74 61 62 6c 65 20 61 6e 64 20 72 65 74  in table and ret
1f20: 75 72 6e 65 64 2e 20 20 48 65 6e 63 65 2c 20 74  urned.  Hence, t
1f30: 77 6f 0a 73 65 70 61 72 61 74 65 20 62 69 6e 61  wo.separate bina
1f40: 72 79 20 73 65 61 72 63 68 65 73 20 61 72 65 20  ry searches are 
1f50: 72 65 71 75 69 72 65 64 20 74 6f 20 66 75 6c 66  required to fulf
1f60: 69 6c 6c 20 74 68 65 20 72 65 71 75 65 73 74 2e  ill the request.
1f70: 0a 0a 3c 70 3e 41 20 57 49 54 48 4f 55 54 20 52  ..<p>A WITHOUT R
1f80: 4f 57 49 44 20 74 61 62 6c 65 20 75 73 65 73 20  OWID table uses 
1f90: 61 20 64 69 66 66 65 72 65 6e 74 20 64 61 74 61  a different data
1fa0: 20 64 65 73 69 67 6e 20 66 6f 72 20 74 68 65 20   design for the 
1fb0: 65 71 75 69 76 61 6c 65 6e 74 0a 74 61 62 6c 65  equivalent.table
1fc0: 2e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c  ...<blockquote><
1fd0: 70 72 65 3e 0a 43 52 45 41 54 45 20 54 41 42 4c  pre>.CREATE TABL
1fe0: 45 20 49 46 20 4e 4f 54 20 45 58 49 53 54 53 20  E IF NOT EXISTS 
1ff0: 77 6f 72 64 63 6f 75 6e 74 28 0a 20 20 77 6f 72  wordcount(.  wor
2000: 64 20 54 45 58 54 20 50 52 49 4d 41 52 59 20 4b  d TEXT PRIMARY K
2010: 45 59 2c 0a 20 20 63 6e 74 20 49 4e 54 45 47 45  EY,.  cnt INTEGE
2020: 52 0a 29 20 57 49 54 48 4f 55 54 20 52 4f 57 49  R.) WITHOUT ROWI
2030: 44 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b  D;.</pre></block
2040: 71 75 6f 74 65 3e 0a 0a 3c 70 3e 49 6e 20 74 68  quote>..<p>In th
2050: 69 73 20 6c 61 74 74 65 72 20 74 61 62 6c 65 2c  is latter table,
2060: 20 74 68 65 72 65 20 69 73 20 6f 6e 6c 79 20 61   there is only a
2070: 20 73 69 6e 67 6c 65 20 42 2d 54 72 65 65 20 77   single B-Tree w
2080: 68 69 63 68 20 75 73 65 73 20 74 68 65 20 22 77  hich uses the "w
2090: 6f 72 64 22 0a 63 6f 6c 75 6d 6e 20 61 73 20 69  ord".column as i
20a0: 74 73 20 6b 65 79 20 61 6e 64 20 74 68 65 20 22  ts key and the "
20b0: 63 6e 74 22 20 63 6f 6c 75 6d 6e 20 61 73 20 69  cnt" column as i
20c0: 74 73 20 64 61 74 61 2e 20 20 28 54 65 63 68 6e  ts data.  (Techn
20d0: 69 63 61 6c 69 74 79 3a 20 20 74 68 65 0a 6c 6f  icality:  the.lo
20e0: 77 2d 6c 65 76 65 6c 20 69 6d 70 6c 65 6d 65 6e  w-level implemen
20f0: 74 61 74 69 6f 6e 20 61 63 74 75 61 6c 6c 79 20  tation actually 
2100: 73 74 6f 72 65 73 20 62 6f 74 68 20 22 77 6f 72  stores both "wor
2110: 64 22 20 61 6e 64 20 22 63 6e 74 22 20 69 6e 20  d" and "cnt" in 
2120: 74 68 65 20 22 6b 65 79 22 0a 61 72 65 61 20 6f  the "key".area o
2130: 66 20 74 68 65 20 42 2d 54 72 65 65 2e 20 20 42  f the B-Tree.  B
2140: 75 74 20 75 6e 6c 65 73 73 20 79 6f 75 20 61 72  ut unless you ar
2150: 65 20 6c 6f 6f 6b 69 6e 67 20 61 74 20 74 68 65  e looking at the
2160: 20 6c 6f 77 2d 6c 65 76 65 6c 20 62 79 74 65 20   low-level byte 
2170: 65 6e 63 6f 64 69 6e 67 0a 6f 66 20 74 68 65 20  encoding.of the 
2180: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74  database file, t
2190: 68 61 74 20 66 61 63 74 20 69 73 20 75 6e 69 6d  hat fact is unim
21a0: 70 6f 72 74 61 6e 74 2e 29 20 20 42 65 63 61 75  portant.)  Becau
21b0: 73 65 20 74 68 65 72 65 20 69 73 20 6f 6e 6c 79  se there is only
21c0: 0a 61 20 73 69 6e 67 6c 65 20 42 2d 54 72 65 65  .a single B-Tree
21d0: 2c 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 68  , the text of th
21e0: 65 20 22 77 6f 72 64 22 20 63 6f 6c 75 6d 6e 20  e "word" column 
21f0: 69 73 20 6f 6e 6c 79 20 73 74 6f 72 65 64 20 6f  is only stored o
2200: 6e 63 65 20 69 6e 20 74 68 65 0a 64 61 74 61 62  nce in the.datab
2210: 61 73 65 2e 20 20 46 75 72 74 68 65 72 6d 6f 72  ase.  Furthermor
2220: 65 2c 20 71 75 65 72 79 69 6e 67 20 74 68 65 20  e, querying the 
2230: 22 63 6e 74 22 20 76 61 6c 75 65 20 66 6f 72 20  "cnt" value for 
2240: 61 20 73 70 65 63 69 66 69 63 20 22 77 6f 72 64  a specific "word
2250: 22 0a 6f 6e 6c 79 20 69 6e 76 6f 6c 76 65 73 20  ".only involves 
2260: 61 20 73 69 6e 67 6c 65 20 62 69 6e 61 72 79 20  a single binary 
2270: 73 65 61 72 63 68 20 69 6e 74 6f 20 74 68 65 20  search into the 
2280: 6d 61 69 6e 20 42 2d 54 72 65 65 2c 20 73 69 6e  main B-Tree, sin
2290: 63 65 20 74 68 65 20 22 63 6e 74 22 0a 76 61 6c  ce the "cnt".val
22a0: 75 65 20 63 61 6e 20 62 65 20 72 65 74 72 69 65  ue can be retrie
22b0: 76 65 64 20 64 69 72 65 63 74 6c 79 20 66 72 6f  ved directly fro
22c0: 6d 20 74 68 65 20 72 65 63 6f 72 64 20 66 6f 75  m the record fou
22d0: 6e 64 20 62 79 20 74 68 61 74 20 66 69 72 73 74  nd by that first
22e0: 20 73 65 61 72 63 68 0a 61 6e 64 20 77 69 74 68   search.and with
22f0: 6f 75 74 20 74 68 65 20 6e 65 65 64 20 74 6f 20  out the need to 
2300: 64 6f 20 61 20 73 65 63 6f 6e 64 20 62 69 6e 61  do a second bina
2310: 72 79 20 73 65 61 72 63 68 20 6f 6e 20 74 68 65  ry search on the
2320: 20 72 6f 77 69 64 2e 0a 0a 3c 70 3e 54 68 75 73   rowid...<p>Thus
2330: 2c 20 69 6e 20 73 6f 6d 65 20 63 61 73 65 73 2c  , in some cases,
2340: 20 61 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44   a WITHOUT ROWID
2350: 20 74 61 62 6c 65 20 63 61 6e 20 75 73 65 20 61   table can use a
2360: 62 6f 75 74 20 68 61 6c 66 20 74 68 65 20 61 6d  bout half the am
2370: 6f 75 6e 74 0a 6f 66 20 64 69 73 6b 20 73 70 61  ount.of disk spa
2380: 63 65 20 61 6e 64 20 63 61 6e 20 6f 70 65 72 61  ce and can opera
2390: 74 65 20 6e 65 61 72 6c 79 20 74 77 69 63 65 20  te nearly twice 
23a0: 61 73 20 66 61 73 74 2e 20 20 4f 66 20 63 6f 75  as fast.  Of cou
23b0: 72 73 65 2c 20 69 6e 20 61 20 0a 72 65 61 6c 2d  rse, in a .real-
23c0: 77 6f 72 6c 64 20 73 63 68 65 6d 61 2c 20 74 68  world schema, th
23d0: 65 72 65 20 77 69 6c 6c 20 74 79 70 69 63 61 6c  ere will typical
23e0: 6c 79 20 62 65 20 73 65 63 6f 6e 64 61 72 79 20  ly be secondary 
23f0: 69 6e 64 69 63 65 73 20 61 6e 64 2f 6f 72 0a 55  indices and/or.U
2400: 4e 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74  NIQUE constraint
2410: 73 2c 20 61 6e 64 20 74 68 65 20 73 69 74 75 61  s, and the situa
2420: 74 69 6f 6e 20 69 73 20 6d 6f 72 65 20 63 6f 6d  tion is more com
2430: 70 6c 69 63 61 74 65 64 2e 20 20 42 75 74 20 65  plicated.  But e
2440: 76 65 6e 20 74 68 65 6e 2c 0a 74 68 65 72 65 20  ven then,.there 
2450: 63 61 6e 20 6f 66 74 65 6e 20 62 65 20 73 70 61  can often be spa
2460: 63 65 20 61 6e 64 20 70 65 72 66 6f 72 6d 61 6e  ce and performan
2470: 63 65 20 61 64 76 61 6e 74 61 67 65 73 20 74 6f  ce advantages to
2480: 20 75 73 69 6e 67 20 57 49 54 48 4f 55 54 20 52   using WITHOUT R
2490: 4f 57 49 44 0a 6f 6e 20 74 61 62 6c 65 73 20 74  OWID.on tables t
24a0: 68 61 74 20 68 61 76 65 20 6e 6f 6e 2d 69 6e 74  hat have non-int
24b0: 65 67 65 72 20 6f 72 20 63 6f 6d 70 6f 73 69 74  eger or composit
24c0: 65 20 50 52 49 4d 41 52 59 20 4b 45 59 73 2e 0a  e PRIMARY KEYs..
24d0: 0a 3c 74 63 6c 3e 68 64 5f 66 72 61 67 6d 65 6e  .<tcl>hd_fragmen
24e0: 74 20 77 74 75 20 7b 77 68 65 6e 20 74 6f 20 75  t wtu {when to u
24f0: 73 65 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44  se WITHOUT ROWID
2500: 7d 3c 2f 74 63 6c 3e 0a 3c 68 31 3e 57 68 65 6e  }</tcl>.<h1>When
2510: 20 54 6f 20 55 73 65 20 57 49 54 48 4f 55 54 20   To Use WITHOUT 
2520: 52 4f 57 49 44 3c 2f 68 31 3e 0a 0a 3c 70 3e 54  ROWID</h1>..<p>T
2530: 68 65 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44  he WITHOUT ROWID
2540: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73   optimization is
2550: 20 6c 69 6b 65 6c 79 20 74 6f 20 62 65 20 68 65   likely to be he
2560: 6c 70 66 75 6c 20 66 6f 72 20 74 61 62 6c 65 73  lpful for tables
2570: 0a 74 68 61 74 20 68 61 76 65 20 6e 6f 6e 2d 69  .that have non-i
2580: 6e 74 65 67 65 72 20 6f 72 20 63 6f 6d 70 6f 73  nteger or compos
2590: 69 74 65 20 28 6d 75 6c 74 69 2d 63 6f 6c 75 6d  ite (multi-colum
25a0: 6e 29 20 50 52 49 4d 41 52 59 20 4b 45 59 73 20  n) PRIMARY KEYs 
25b0: 61 6e 64 20 74 68 61 74 20 64 6f 0a 6e 6f 74 20  and that do.not 
25c0: 73 74 6f 72 65 20 6c 61 72 67 65 20 73 74 72 69  store large stri
25d0: 6e 67 73 20 6f 72 20 42 4c 4f 42 73 2e 3c 2f 70  ngs or BLOBs.</p
25e0: 3e 0a 0a 3c 70 3e 57 49 54 48 4f 55 54 20 52 4f  >..<p>WITHOUT RO
25f0: 57 49 44 20 74 61 62 6c 65 73 20 77 69 6c 6c 20  WID tables will 
2600: 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 20 28  work correctly (
2610: 74 68 61 74 20 69 73 20 74 6f 20 73 61 79 2c 20  that is to say, 
2620: 74 68 65 79 0a 70 72 6f 76 69 64 65 20 74 68 65  they.provide the
2630: 20 63 6f 72 72 65 63 74 20 61 6e 73 77 65 72 29   correct answer)
2640: 20 66 6f 72 20 74 61 62 6c 65 73 20 77 69 74 68   for tables with
2650: 20 61 20 73 69 6e 67 6c 65 20 49 4e 54 45 47 45   a single INTEGE
2660: 52 20 50 52 49 4d 41 52 59 20 4b 45 59 2e 20 0a  R PRIMARY KEY. .
2670: 48 6f 77 65 76 65 72 2c 20 6f 72 64 69 6e 61 72  However, ordinar
2680: 79 20 72 6f 77 69 64 20 74 61 62 6c 65 73 20 77  y rowid tables w
2690: 69 6c 6c 20 72 75 6e 20 66 61 73 74 65 72 20 69  ill run faster i
26a0: 6e 20 74 68 61 74 20 63 61 73 65 2e 20 20 0a 48  n that case.  .H
26b0: 65 6e 63 65 2c 20 69 74 20 69 73 20 67 6f 6f 64  ence, it is good
26c0: 20 64 65 73 69 67 6e 0a 74 6f 20 61 76 6f 69 64   design.to avoid
26d0: 20 63 72 65 61 74 69 6e 67 20 57 49 54 48 4f 55   creating WITHOU
26e0: 54 20 52 4f 57 49 44 20 74 61 62 6c 65 73 20 77  T ROWID tables w
26f0: 69 74 68 20 73 69 6e 67 6c 65 2d 63 6f 6c 75 6d  ith single-colum
2700: 6e 20 50 52 49 4d 41 52 59 20 4b 45 59 73 20 0a  n PRIMARY KEYs .
2710: 6f 66 20 74 79 70 65 20 49 4e 54 45 47 45 52 2e  of type INTEGER.
2720: 0a 0a 3c 70 3e 57 49 54 48 4f 55 54 20 52 4f 57  ..<p>WITHOUT ROW
2730: 49 44 20 74 61 62 6c 65 73 20 77 6f 72 6b 20 62  ID tables work b
2740: 65 73 74 20 77 68 65 6e 20 69 6e 64 69 76 69 64  est when individ
2750: 75 61 6c 20 72 6f 77 73 20 61 72 65 20 6e 6f 74  ual rows are not
2760: 20 74 6f 6f 20 6c 61 72 67 65 2e 0a 41 20 67 6f   too large..A go
2770: 6f 64 20 72 75 6c 65 2d 6f 66 2d 74 68 75 6d 62  od rule-of-thumb
2780: 20 69 73 20 74 68 61 74 20 74 68 65 20 61 76 65   is that the ave
2790: 72 61 67 65 20 73 69 7a 65 20 6f 66 20 61 20 73  rage size of a s
27a0: 69 6e 67 6c 65 20 72 6f 77 20 69 6e 20 61 0a 57  ingle row in a.W
27b0: 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74 61 62  ITHOUT ROWID tab
27c0: 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 6c 65 73  le should be les
27d0: 73 20 74 68 61 6e 20 61 62 6f 75 74 20 31 2f 32  s than about 1/2
27e0: 30 74 68 20 74 68 65 20 73 69 7a 65 20 6f 66 20  0th the size of 
27f0: 0a 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65  .a database page
2800: 2e 20 20 54 68 61 74 20 6d 65 61 6e 73 20 74 68  .  That means th
2810: 61 74 20 72 6f 77 73 20 73 68 6f 75 6c 64 20 6e  at rows should n
2820: 6f 74 20 63 6f 6e 74 61 69 6e 20 6d 6f 72 65 20  ot contain more 
2830: 74 68 61 6e 20 61 62 6f 75 74 0a 35 30 20 62 79  than about.50 by
2840: 74 65 73 20 65 61 63 68 20 66 6f 72 20 61 20 31  tes each for a 1
2850: 4b 69 42 20 70 61 67 65 20 73 69 7a 65 20 6f 72  KiB page size or
2860: 20 61 62 6f 75 74 20 32 30 30 20 62 79 74 65 73   about 200 bytes
2870: 20 65 61 63 68 20 66 6f 72 20 34 4b 69 42 0a 70   each for 4KiB.p
2880: 61 67 65 20 73 69 7a 65 2e 20 20 57 49 54 48 4f  age size.  WITHO
2890: 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 73 20  UT ROWID tables 
28a0: 77 69 6c 6c 20 77 6f 72 6b 20 28 69 6e 20 74 68  will work (in th
28b0: 65 20 73 65 6e 73 65 20 74 68 61 74 0a 74 68 65  e sense that.the
28c0: 79 20 67 65 74 20 74 68 65 20 63 6f 72 72 65 63  y get the correc
28d0: 74 20 61 6e 73 77 65 72 29 20 66 6f 72 20 61 72  t answer) for ar
28e0: 62 69 74 72 61 72 69 6c 79 20 6c 61 72 67 65 20  bitrarily large 
28f0: 72 6f 77 73 20 2d 20 75 70 20 74 6f 20 32 47 42  rows - up to 2GB
2900: 20 69 6e 20 73 69 7a 65 20 2d 0a 62 75 74 20 74   in size -.but t
2910: 72 61 64 69 74 69 6f 6e 61 6c 20 72 6f 77 69 64  raditional rowid
2920: 20 74 61 62 6c 65 73 20 74 65 6e 64 20 74 6f 20   tables tend to 
2930: 77 6f 72 6b 20 66 61 73 74 65 72 20 66 6f 72 20  work faster for 
2940: 6c 61 72 67 65 20 72 6f 77 20 73 69 7a 65 73 2e  large row sizes.
2950: 0a 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65  .This is because
2960: 20 72 6f 77 69 64 20 74 61 62 6c 65 73 20 61 72   rowid tables ar
2970: 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73  e implemented as
2980: 20 5b 42 2a 2d 54 72 65 65 73 5d 20 77 68 65 72   [B*-Trees] wher
2990: 65 0a 61 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 73  e.all content is
29a0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 6c   stored in the l
29b0: 65 61 76 65 73 20 6f 66 20 74 68 65 20 74 72 65  eaves of the tre
29c0: 65 2c 20 77 68 65 72 65 61 73 20 57 49 54 48 4f  e, whereas WITHO
29d0: 55 54 20 52 4f 57 49 44 20 0a 74 61 62 6c 65 73  UT ROWID .tables
29e0: 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64   are implemented
29f0: 20 75 73 69 6e 67 20 6f 72 64 69 6e 61 72 79 20   using ordinary 
2a00: 42 2d 54 72 65 65 73 20 77 69 74 68 20 63 6f 6e  B-Trees with con
2a10: 74 65 6e 74 20 73 74 6f 72 65 64 20 6f 6e 20 62  tent stored on b
2a20: 6f 74 68 0a 6c 65 61 76 65 73 20 61 6e 64 20 69  oth.leaves and i
2a30: 6e 74 65 72 6d 65 64 69 61 74 65 20 6e 6f 64 65  ntermediate node
2a40: 73 2e 20 20 53 74 6f 72 69 6e 67 20 63 6f 6e 74  s.  Storing cont
2a50: 65 6e 74 20 69 6e 20 0a 69 6e 74 65 72 6d 65 64  ent in .intermed
2a60: 69 61 74 65 20 6e 6f 64 65 73 20 6d 65 61 6e 20  iate nodes mean 
2a70: 74 68 61 74 20 65 61 63 68 20 69 6e 74 65 72 6d  that each interm
2a80: 65 64 69 61 74 65 20 6e 6f 64 65 20 65 6e 74 72  ediate node entr
2a90: 79 20 74 61 6b 65 73 20 75 70 20 6d 6f 72 65 0a  y takes up more.
2aa0: 73 70 61 63 65 20 6f 6e 20 74 68 65 20 70 61 67  space on the pag
2ab0: 65 20 61 6e 64 20 74 68 75 73 20 72 65 64 75 63  e and thus reduc
2ac0: 65 73 20 74 68 65 20 66 61 6e 2d 6f 75 74 2c 20  es the fan-out, 
2ad0: 69 6e 63 72 65 61 73 69 6e 67 20 74 68 65 20 73  increasing the s
2ae0: 65 61 72 63 68 20 63 6f 73 74 2e 0a 0a 3c 70 3e  earch cost...<p>
2af0: 54 68 65 20 22 73 71 6c 69 74 65 33 5f 61 6e 61  The "sqlite3_ana
2b00: 6c 79 7a 65 72 2e 65 78 65 22 20 75 74 69 6c 69  lyzer.exe" utili
2b10: 74 79 20 70 72 6f 67 72 61 6d 2c 20 61 76 61 69  ty program, avai
2b20: 6c 61 62 6c 65 20 61 73 20 73 6f 75 72 63 65 20  lable as source 
2b30: 63 6f 64 65 0a 69 6e 20 74 68 65 20 53 51 4c 69  code.in the SQLi
2b40: 74 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 6f  te source tree o
2b50: 72 20 61 73 20 61 20 70 72 65 63 6f 6d 70 69 6c  r as a precompil
2b60: 65 64 20 62 69 6e 61 72 79 20 6f 6e 20 74 68 65  ed binary on the
2b70: 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c  .[http://www.sql
2b80: 69 74 65 2e 6f 72 67 2f 64 6f 77 6e 6c 6f 61 64  ite.org/download
2b90: 2e 68 74 6d 6c 20 7c 20 53 51 4c 69 74 65 20 44  .html | SQLite D
2ba0: 6f 77 6e 6c 6f 61 64 20 70 61 67 65 5d 2c 20 63  ownload page], c
2bb0: 61 6e 20 62 65 0a 75 73 65 64 20 74 6f 20 6d 65  an be.used to me
2bc0: 61 73 75 72 65 20 74 68 65 20 61 76 65 72 61 67  asure the averag
2bd0: 65 20 73 69 7a 65 73 20 6f 66 20 74 61 62 6c 65  e sizes of table
2be0: 20 72 6f 77 73 20 69 6e 20 61 6e 20 65 78 69 73   rows in an exis
2bf0: 74 69 6e 67 20 53 51 4c 69 74 65 0a 64 61 74 61  ting SQLite.data
2c00: 62 61 73 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4e 6f  base.</p>..<p>No
2c10: 74 65 20 74 68 61 74 20 65 78 63 65 70 74 20 66  te that except f
2c20: 6f 72 20 61 20 66 65 77 20 63 6f 72 6e 65 72 2d  or a few corner-
2c30: 63 61 73 65 20 64 69 66 66 65 72 65 6e 63 65 73  case differences
2c40: 20 64 65 74 61 69 6c 65 64 20 61 62 6f 76 65 2c   detailed above,
2c50: 0a 57 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74  .WITHOUT ROWID t
2c60: 61 62 6c 65 73 20 61 6e 64 20 72 6f 77 69 64 20  ables and rowid 
2c70: 74 61 62 6c 65 73 20 77 6f 72 6b 20 74 68 65 20  tables work the 
2c80: 73 61 6d 65 2e 20 20 54 68 65 79 20 62 6f 74 68  same.  They both
2c90: 20 67 65 6e 65 72 61 74 65 0a 74 68 65 20 73 61   generate.the sa
2ca0: 6d 65 20 61 6e 73 77 65 72 73 20 67 69 76 65 6e  me answers given
2cb0: 20 74 68 65 20 73 61 6d 65 20 53 51 4c 20 73 74   the same SQL st
2cc0: 61 74 65 6d 65 6e 74 73 2e 20 20 53 6f 20 69 74  atements.  So it
2cd0: 20 69 73 20 61 20 73 69 6d 70 6c 65 20 6d 61 74   is a simple mat
2ce0: 74 65 72 0a 74 6f 20 72 75 6e 20 65 78 70 65 72  ter.to run exper
2cf0: 69 6d 65 6e 74 73 20 6f 6e 20 61 6e 20 61 70 70  iments on an app
2d00: 6c 69 63 61 74 69 6f 6e 2c 20 6c 61 74 65 20 69  lication, late i
2d10: 6e 20 74 68 65 20 64 65 76 65 6c 6f 70 6d 65 6e  n the developmen
2d20: 74 20 63 79 63 6c 65 2c 0a 74 6f 20 74 65 73 74  t cycle,.to test
2d30: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
2d40: 74 68 65 20 75 73 65 20 6f 66 20 57 49 54 48 4f  the use of WITHO
2d50: 55 54 20 52 4f 57 49 44 20 74 61 62 6c 65 73 20  UT ROWID tables 
2d60: 77 69 6c 6c 20 62 65 20 68 65 6c 70 66 75 6c 2e  will be helpful.
2d70: 0a 41 20 67 6f 6f 64 20 73 74 72 61 74 65 67 79  .A good strategy
2d80: 20 69 73 20 74 6f 20 73 69 6d 70 6c 79 20 6e 6f   is to simply no
2d90: 74 20 77 6f 72 72 79 20 61 62 6f 75 74 20 57 49  t worry about WI
2da0: 54 48 4f 55 54 20 52 4f 57 49 44 20 75 6e 74 69  THOUT ROWID unti
2db0: 6c 20 6e 65 61 72 0a 74 68 65 20 65 6e 64 20 6f  l near.the end o
2dc0: 66 20 70 72 6f 64 75 63 74 20 64 65 76 65 6c 6f  f product develo
2dd0: 70 6d 65 6e 74 2c 20 74 68 65 6e 20 67 6f 20 62  pment, then go b
2de0: 61 63 6b 20 61 6e 64 20 72 75 6e 20 74 65 73 74  ack and run test
2df0: 73 20 74 6f 20 73 65 65 0a 69 66 20 61 64 64 69  s to see.if addi
2e00: 6e 67 20 57 49 54 48 4f 55 54 20 52 4f 57 49 44  ng WITHOUT ROWID
2e10: 20 74 6f 20 74 61 62 6c 65 73 20 77 69 74 68 20   to tables with 
2e20: 6e 6f 6e 2d 69 6e 74 65 67 65 72 20 50 52 49 4d  non-integer PRIM
2e30: 41 52 59 20 4b 45 59 73 20 68 65 6c 70 73 0a 6f  ARY KEYs helps.o
2e40: 72 20 68 75 72 74 73 20 70 65 72 66 6f 72 6d 61  r hurts performa
2e50: 6e 63 65 2c 20 61 6e 64 20 72 65 74 61 69 6e 69  nce, and retaini
2e60: 6e 67 20 74 68 65 20 57 49 54 48 4f 55 54 20 52  ng the WITHOUT R
2e70: 4f 57 49 44 20 6f 6e 6c 79 20 69 6e 20 74 68 6f  OWID only in tho
2e80: 73 65 20 63 61 73 65 73 0a 77 68 65 72 65 20 69  se cases.where i
2e90: 74 20 68 65 6c 70 73 2e 0a                       t helps..