Documentation Source Text

Hex Artifact Content
Login

Artifact 8f864329860ce33437d8e973bca84eb51ff3c5ce:


0000: 3c 74 69 74 6c 65 3e 55 73 69 6e 67 20 53 51 4c  <title>Using SQL
0010: 69 74 65 20 49 6e 20 4d 75 6c 74 69 2d 54 68 72  ite In Multi-Thr
0020: 65 61 64 65 64 20 41 70 70 6c 69 63 61 74 69 6f  eaded Applicatio
0030: 6e 73 3c 2f 74 69 74 6c 65 3e 0a 3c 74 63 6c 3e  ns</title>.<tcl>
0040: 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b 74 68 72  hd_keywords {thr
0050: 65 61 64 69 6e 67 20 6d 6f 64 65 7d 3c 2f 74 63  eading mode}</tc
0060: 6c 3e 0a 0a 3c 66 61 6e 63 79 5f 66 6f 72 6d 61  l>..<fancy_forma
0070: 74 3e 0a 0a 3c 68 31 3e 4f 76 65 72 76 69 65 77  t>..<h1>Overview
0080: 3c 2f 68 31 3e 0a 0a 3c 70 3e 53 51 4c 69 74 65  </h1>..<p>SQLite
0090: 20 73 75 70 70 6f 72 74 73 20 74 68 72 65 65 20   supports three 
00a0: 64 69 66 66 65 72 65 6e 74 20 74 68 72 65 61 64  different thread
00b0: 69 6e 67 20 6d 6f 64 65 73 3a 3c 2f 70 3e 0a 0a  ing modes:</p>..
00c0: 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 53  <ol>.<li><p><b>S
00d0: 69 6e 67 6c 65 2d 74 68 72 65 61 64 3c 2f 62 3e  ingle-thread</b>
00e0: 2e 0a 49 6e 20 74 68 69 73 20 6d 6f 64 65 2c 20  ..In this mode, 
00f0: 61 6c 6c 20 6d 75 74 65 78 65 73 20 61 72 65 20  all mutexes are 
0100: 64 69 73 61 62 6c 65 64 20 61 6e 64 20 53 51 4c  disabled and SQL
0110: 69 74 65 20 69 73 20 75 6e 73 61 66 65 20 74 6f  ite is unsafe to
0120: 20 75 73 65 20 69 6e 0a 6d 6f 72 65 20 74 68 61   use in.more tha
0130: 6e 20 61 20 73 69 6e 67 6c 65 20 74 68 72 65 61  n a single threa
0140: 64 20 61 74 20 6f 6e 63 65 2e 3c 2f 70 3e 3c 2f  d at once.</p></
0150: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 4d  li>..<li><p><b>M
0160: 75 6c 74 69 2d 74 68 72 65 61 64 3c 2f 62 3e 2e  ulti-thread</b>.
0170: 0a 49 6e 20 74 68 69 73 20 6d 6f 64 65 2c 20 53  .In this mode, S
0180: 51 4c 69 74 65 20 63 61 6e 20 62 65 20 73 61 66  QLite can be saf
0190: 65 6c 79 20 75 73 65 64 20 62 79 20 6d 75 6c 74  ely used by mult
01a0: 69 70 6c 65 20 74 68 72 65 61 64 73 20 70 72 6f  iple threads pro
01b0: 76 69 64 65 64 20 74 68 61 74 0a 6e 6f 20 73 69  vided that.no si
01c0: 6e 67 6c 65 20 64 61 74 61 62 61 73 65 20 63 6f  ngle database co
01d0: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 75 73 65 64  nnection is used
01e0: 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 20   simultaneously 
01f0: 69 6e 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 74  in two or more t
0200: 68 72 65 61 64 73 2e 0a 3c 2f 70 3e 3c 2f 6c 69  hreads..</p></li
0210: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 53 65 72  >..<li><p><b>Ser
0220: 69 61 6c 69 7a 65 64 3c 2f 62 3e 2e 0a 49 6e 20  ialized</b>..In 
0230: 73 65 72 69 61 6c 69 7a 65 64 20 6d 6f 64 65 2c  serialized mode,
0240: 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 20 73   SQLite can be s
0250: 61 66 65 6c 79 20 75 73 65 64 20 62 79 20 6d 75  afely used by mu
0260: 6c 74 69 70 6c 65 20 74 68 72 65 61 64 73 20 77  ltiple threads w
0270: 69 74 68 20 6e 6f 0a 72 65 73 74 72 69 63 74 69  ith no.restricti
0280: 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 6f  on.</p></li>.</o
0290: 6c 3e 0a 0a 3c 70 3e 0a 54 68 65 20 74 68 72 65  l>..<p>.The thre
02a0: 61 64 69 6e 67 20 6d 6f 64 65 20 63 61 6e 20 62  ading mode can b
02b0: 65 20 73 65 6c 65 63 74 65 64 20 61 74 20 63 6f  e selected at co
02c0: 6d 70 69 6c 65 2d 74 69 6d 65 20 28 77 68 65 6e  mpile-time (when
02d0: 20 74 68 65 20 53 51 4c 69 74 65 0a 6c 69 62 72   the SQLite.libr
02e0: 61 72 79 20 69 73 20 62 65 69 6e 67 20 63 6f 6d  ary is being com
02f0: 70 69 6c 65 64 20 66 72 6f 6d 20 73 6f 75 72 63  piled from sourc
0300: 65 20 63 6f 64 65 29 20 6f 72 20 61 74 20 73 74  e code) or at st
0310: 61 72 74 2d 74 69 6d 65 20 28 77 68 65 6e 20 74  art-time (when t
0320: 68 65 0a 61 70 70 6c 69 63 61 74 69 6f 6e 20 74  he.application t
0330: 68 61 74 20 69 6e 74 65 6e 64 73 20 74 6f 20 75  hat intends to u
0340: 73 65 20 53 51 4c 69 74 65 20 69 73 20 69 6e 69  se SQLite is ini
0350: 74 69 61 6c 69 7a 69 6e 67 29 20 6f 72 20 61 74  tializing) or at
0360: 0a 72 75 6e 2d 74 69 6d 65 20 28 77 68 65 6e 20  .run-time (when 
0370: 61 20 6e 65 77 20 53 51 4c 69 74 65 20 64 61 74  a new SQLite dat
0380: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
0390: 20 69 73 20 62 65 69 6e 67 20 63 72 65 61 74 65   is being create
03a0: 64 29 2e 0a 47 65 6e 65 72 61 6c 6c 79 20 73 70  d)..Generally sp
03b0: 65 61 6b 69 6e 67 2c 20 72 75 6e 2d 74 69 6d 65  eaking, run-time
03c0: 20 6f 76 65 72 72 69 64 65 73 20 73 74 61 72 74   overrides start
03d0: 2d 74 69 6d 65 20 61 6e 64 20 73 74 61 72 74 2d  -time and start-
03e0: 74 69 6d 65 0a 6f 76 65 72 72 69 64 65 73 20 63  time.overrides c
03f0: 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e 20 20 45 78  ompile-time.  Ex
0400: 63 65 70 74 2c 20 73 69 6e 67 6c 65 2d 74 68 72  cept, single-thr
0410: 65 61 64 20 6d 6f 64 65 20 63 61 6e 6e 6f 74 20  ead mode cannot 
0420: 62 65 20 0a 6f 76 65 72 72 69 64 64 65 6e 20 6f  be .overridden o
0430: 6e 63 65 20 73 65 6c 65 63 74 65 64 2e 0a 3c 2f  nce selected..</
0440: 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 64 65 66 61  p>..<p>.The defa
0450: 75 6c 74 20 6d 6f 64 65 20 69 73 20 73 65 72 69  ult mode is seri
0460: 61 6c 69 7a 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 68  alized..</p>..<h
0470: 31 3e 43 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 73  1>Compile-time s
0480: 65 6c 65 63 74 69 6f 6e 20 6f 66 20 74 68 72 65  election of thre
0490: 61 64 69 6e 67 20 6d 6f 64 65 3c 2f 68 31 3e 0a  ading mode</h1>.
04a0: 0a 3c 70 3e 0a 55 73 65 20 74 68 65 20 5b 53 51  .<p>.Use the [SQ
04b0: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 5d  LITE_THREADSAFE]
04c0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 70 61   compile-time pa
04d0: 72 61 6d 65 74 65 72 20 74 6f 20 73 65 6c 65 63  rameter to selec
04e0: 74 65 64 20 74 68 65 0a 74 68 72 65 61 64 69 6e  ted the.threadin
04f0: 67 20 6d 6f 64 65 2e 20 20 49 66 20 6e 6f 20 5b  g mode.  If no [
0500: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46  SQLITE_THREADSAF
0510: 45 5d 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20  E] compile-time 
0520: 70 61 72 61 6d 65 74 65 72 20 69 73 0a 70 72 65  parameter is.pre
0530: 73 65 6e 74 2c 20 74 68 65 6e 20 73 65 72 69 61  sent, then seria
0540: 6c 69 7a 65 64 20 6d 6f 64 65 20 69 73 20 75 73  lized mode is us
0550: 65 64 2e 0a 54 68 69 73 20 63 61 6e 20 62 65 20  ed..This can be 
0560: 6d 61 64 65 20 65 78 70 6c 69 63 69 74 20 77 69  made explicit wi
0570: 74 68 20 0a 5b 53 51 4c 49 54 45 5f 54 48 52 45  th .[SQLITE_THRE
0580: 41 44 53 41 46 45 20 7c 20 2d 44 53 51 4c 49 54  ADSAFE | -DSQLIT
0590: 45 5f 54 48 52 45 41 44 53 41 46 45 3d 31 5d 2e  E_THREADSAFE=1].
05a0: 0a 57 69 74 68 0a 5b 53 51 4c 49 54 45 5f 54 48  .With.[SQLITE_TH
05b0: 52 45 41 44 53 41 46 45 20 7c 20 2d 44 53 51 4c  READSAFE | -DSQL
05c0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d 30  ITE_THREADSAFE=0
05d0: 5d 20 74 68 65 20 74 68 72 65 61 64 69 6e 67 20  ] the threading 
05e0: 6d 6f 64 65 20 69 73 0a 73 69 6e 67 6c 65 2d 74  mode is.single-t
05f0: 68 72 65 61 64 2e 20 20 57 69 74 68 0a 5b 53 51  hread.  With.[SQ
0600: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20  LITE_THREADSAFE 
0610: 7c 20 2d 44 53 51 4c 49 54 45 5f 54 48 52 45 41  | -DSQLITE_THREA
0620: 44 53 41 46 45 3d 32 5d 20 74 68 65 20 74 68 72  DSAFE=2] the thr
0630: 65 61 64 69 6e 67 20 6d 6f 64 65 20 69 73 0a 6d  eading mode is.m
0640: 75 6c 74 69 2d 74 68 72 65 61 64 2e 0a 3c 2f 70  ulti-thread..</p
0650: 3e 0a 0a 3c 70 3e 0a 54 68 65 20 72 65 74 75 72  >..<p>.The retur
0660: 6e 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 5b  n value of the [
0670: 73 71 6c 69 74 65 33 5f 74 68 72 65 61 64 73 61  sqlite3_threadsa
0680: 66 65 28 29 5d 20 69 6e 74 65 72 66 61 63 65 20  fe()] interface 
0690: 69 73 20 64 65 74 65 72 6d 69 6e 65 64 0a 62 79  is determined.by
06a0: 20 74 68 65 20 63 6f 6d 70 69 6c 65 2d 74 69 6d   the compile-tim
06b0: 65 20 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65  e threading mode
06c0: 20 73 65 6c 65 63 74 69 6f 6e 2e 20 20 49 66 20   selection.  If 
06d0: 73 69 6e 67 6c 65 2d 74 68 72 65 61 64 20 6d 6f  single-thread mo
06e0: 64 65 0a 69 73 20 73 65 6c 65 63 74 65 64 20 61  de.is selected a
06f0: 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2c 20  t compile-time, 
0700: 74 68 65 6e 20 5b 73 71 6c 69 74 65 33 5f 74 68  then [sqlite3_th
0710: 72 65 61 64 73 61 66 65 28 29 5d 20 72 65 74 75  readsafe()] retu
0720: 72 6e 73 20 66 61 6c 73 65 2e 0a 49 66 20 65 69  rns false..If ei
0730: 74 68 65 72 20 74 68 65 20 6d 75 6c 74 69 2d 74  ther the multi-t
0740: 68 72 65 61 64 20 6f 72 20 73 65 72 69 61 6c 69  hread or seriali
0750: 7a 65 64 20 6d 6f 64 65 73 20 61 72 65 20 73 65  zed modes are se
0760: 6c 65 63 74 65 64 2c 20 74 68 65 6e 0a 5b 73 71  lected, then.[sq
0770: 6c 69 74 65 33 5f 74 68 72 65 61 64 73 61 66 65  lite3_threadsafe
0780: 28 29 5d 20 72 65 74 75 72 6e 73 20 74 72 75 65  ()] returns true
0790: 2e 20 20 54 68 65 20 5b 73 71 6c 69 74 65 33 5f  .  The [sqlite3_
07a0: 74 68 72 65 61 64 73 61 66 65 28 29 5d 0a 69 6e  threadsafe()].in
07b0: 74 65 72 66 61 63 65 20 70 72 65 64 61 74 65 73  terface predates
07c0: 20 74 68 65 20 6d 75 6c 74 69 2d 74 68 72 65 61   the multi-threa
07d0: 64 20 6d 6f 64 65 20 61 6e 64 20 73 74 61 72 74  d mode and start
07e0: 2d 74 69 6d 65 20 61 6e 64 20 72 75 6e 2d 74 69  -time and run-ti
07f0: 6d 65 0a 6d 6f 64 65 20 73 65 6c 65 63 74 69 6f  me.mode selectio
0800: 6e 20 61 6e 64 20 73 6f 20 69 73 20 75 6e 61 62  n and so is unab
0810: 6c 65 20 74 6f 20 64 69 73 74 69 6e 67 75 69 73  le to distinguis
0820: 68 0a 62 65 74 77 65 65 6e 20 6d 75 6c 74 69 2d  h.between multi-
0830: 74 68 72 65 61 64 20 61 6e 64 20 73 65 72 69 61  thread and seria
0840: 6c 69 7a 65 64 20 6d 6f 64 65 20 6e 6f 72 20 69  lized mode nor i
0850: 73 20 69 74 20 61 62 6c 65 20 74 6f 20 72 65 70  s it able to rep
0860: 6f 72 74 20 73 74 61 72 74 2d 74 69 6d 65 0a 6f  ort start-time.o
0870: 72 20 72 75 6e 2d 74 69 6d 65 20 6d 6f 64 65 20  r run-time mode 
0880: 63 68 61 6e 67 65 73 2e 0a 3c 2f 70 3e 0a 0a 3c  changes..</p>..<
0890: 70 3e 0a 49 66 20 73 69 6e 67 6c 65 2d 74 68 72  p>.If single-thr
08a0: 65 61 64 20 6d 6f 64 65 20 69 73 20 73 65 6c 65  ead mode is sele
08b0: 63 74 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d  cted at compile-
08c0: 74 69 6d 65 2c 20 74 68 65 6e 20 63 72 69 74 69  time, then criti
08d0: 63 61 6c 0a 6d 75 74 65 78 69 6e 67 20 6c 6f 67  cal.mutexing log
08e0: 69 63 20 69 73 20 6f 6d 69 74 74 65 64 20 66 72  ic is omitted fr
08f0: 6f 6d 20 74 68 65 20 62 75 69 6c 64 20 61 6e 64  om the build and
0900: 20 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 6c   it is impossibl
0910: 65 20 74 6f 0a 65 6e 61 62 6c 65 20 65 69 74 68  e to.enable eith
0920: 65 72 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 20  er multi-thread 
0930: 6f 72 20 73 65 72 69 61 6c 69 7a 65 64 20 6d 6f  or serialized mo
0940: 64 65 73 20 61 74 20 73 74 61 72 74 2d 74 69 6d  des at start-tim
0950: 65 20 6f 72 0a 72 75 6e 2d 74 69 6d 65 2e 0a 3c  e or.run-time..<
0960: 2f 70 3e 0a 0a 3c 68 31 3e 53 74 61 72 74 2d 74  /p>..<h1>Start-t
0970: 69 6d 65 20 73 65 6c 65 63 74 69 6f 6e 20 6f 66  ime selection of
0980: 20 74 68 72 65 61 64 69 6e 67 20 6d 6f 64 65 3c   threading mode<
0990: 2f 68 31 3e 0a 0a 3c 70 3e 0a 41 73 73 75 6d 69  /h1>..<p>.Assumi
09a0: 6e 67 20 74 68 61 74 20 74 68 65 20 63 6f 6d 70  ng that the comp
09b0: 69 6c 65 2d 74 69 6d 65 20 74 68 72 65 61 64 69  ile-time threadi
09c0: 6e 67 20 6d 6f 64 65 20 69 73 20 6e 6f 74 20 73  ng mode is not s
09d0: 69 6e 67 6c 65 2d 74 68 72 65 61 64 2c 20 74 68  ingle-thread, th
09e0: 65 6e 0a 74 68 65 20 74 68 72 65 61 64 69 6e 67  en.the threading
09f0: 20 6d 6f 64 65 20 63 61 6e 20 62 65 20 63 68 61   mode can be cha
0a00: 6e 67 65 64 20 64 75 72 69 6e 67 20 69 6e 69 74  nged during init
0a10: 69 61 6c 69 7a 61 74 69 6f 6e 20 75 73 69 6e 67  ialization using
0a20: 20 74 68 65 0a 5b 73 71 6c 69 74 65 33 5f 63 6f   the.[sqlite3_co
0a30: 6e 66 69 67 28 29 5d 20 69 6e 74 65 72 66 61 63  nfig()] interfac
0a40: 65 2e 20 20 54 68 65 20 5b 53 51 4c 49 54 45 5f  e.  The [SQLITE_
0a50: 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52  CONFIG_SINGLETHR
0a60: 45 41 44 5d 20 76 65 72 62 0a 70 75 74 73 20 53  EAD] verb.puts S
0a70: 51 4c 69 74 65 20 69 6e 74 6f 20 73 69 6e 67 6c  QLite into singl
0a80: 65 2d 74 68 72 65 61 64 20 6d 6f 64 65 2c 20 74  e-thread mode, t
0a90: 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46 49  he [SQLITE_CONFI
0aa0: 47 5f 4d 55 4c 54 49 54 48 52 45 41 44 5d 0a 76  G_MULTITHREAD].v
0ab0: 65 72 62 20 73 65 74 73 20 6d 75 6c 74 69 2d 74  erb sets multi-t
0ac0: 68 72 65 61 64 20 6d 6f 64 65 2c 20 61 6e 64 20  hread mode, and 
0ad0: 74 68 65 20 5b 53 51 4c 49 54 45 5f 43 4f 4e 46  the [SQLITE_CONF
0ae0: 49 47 5f 53 45 52 49 41 4c 49 5a 45 44 5d 20 76  IG_SERIALIZED] v
0af0: 65 72 62 0a 73 65 74 73 20 73 65 72 69 61 6c 69  erb.sets seriali
0b00: 7a 65 64 20 6d 6f 64 65 2e 0a 3c 2f 70 3e 0a 0a  zed mode..</p>..
0b10: 3c 68 31 3e 52 75 6e 2d 74 69 6d 65 20 73 65 6c  <h1>Run-time sel
0b20: 65 63 74 69 6f 6e 20 6f 66 20 74 68 72 65 61 64  ection of thread
0b30: 69 6e 67 20 6d 6f 64 65 3c 2f 68 31 3e 0a 0a 3c  ing mode</h1>..<
0b40: 70 3e 49 66 20 73 69 6e 67 6c 65 2d 74 68 72 65  p>If single-thre
0b50: 61 64 20 6d 6f 64 65 20 68 61 73 20 6e 6f 74 20  ad mode has not 
0b60: 62 65 65 6e 20 73 65 6c 65 63 74 65 64 20 61 74  been selected at
0b70: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 72   compile-time or
0b80: 20 73 74 61 72 74 2d 74 69 6d 65 2c 0a 74 68 65   start-time,.the
0b90: 6e 20 69 6e 64 69 76 69 64 75 61 6c 20 64 61 74  n individual dat
0ba0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
0bb0: 73 20 63 61 6e 20 62 65 20 63 72 65 61 74 65 64  s can be created
0bc0: 20 61 73 20 65 69 74 68 65 72 20 6d 75 6c 74 69   as either multi
0bd0: 2d 74 68 72 65 61 64 0a 6f 72 20 73 65 72 69 61  -thread.or seria
0be0: 6c 69 7a 65 64 2e 20 20 49 74 20 69 73 20 6e 6f  lized.  It is no
0bf0: 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 6f  t possible to do
0c00: 77 6e 67 72 61 64 65 20 61 6e 20 69 6e 64 69 76  wngrade an indiv
0c10: 69 64 75 61 6c 20 64 61 74 61 62 61 73 65 0a 63  idual database.c
0c20: 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 73 69 6e  onnection to sin
0c30: 67 6c 65 2d 74 68 72 65 61 64 20 6d 6f 64 65 2e  gle-thread mode.
0c40: 20 20 4e 6f 72 20 69 73 20 69 74 20 70 6f 73 73    Nor is it poss
0c50: 69 62 6c 65 20 74 6f 20 65 73 63 61 6c 61 74 65  ible to escalate
0c60: 20 61 6e 0a 69 6e 64 69 76 69 64 75 61 6c 20 64   an.individual d
0c70: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
0c80: 6f 6e 20 69 66 20 74 68 65 20 63 6f 6d 70 69 6c  on if the compil
0c90: 65 2d 74 69 6d 65 20 6f 72 20 73 74 61 72 74 2d  e-time or start-
0ca0: 74 69 6d 65 20 6d 6f 64 65 0a 69 73 20 73 69 6e  time mode.is sin
0cb0: 67 6c 65 2d 74 68 72 65 61 64 2e 3c 2f 70 3e 0a  gle-thread.</p>.
0cc0: 0a 3c 70 3e 54 68 65 20 74 68 72 65 61 64 69 6e  .<p>The threadin
0cd0: 67 20 6d 6f 64 65 20 66 6f 72 20 61 6e 20 69 6e  g mode for an in
0ce0: 64 69 76 69 64 75 61 6c 20 64 61 74 61 62 61 73  dividual databas
0cf0: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20  e connection is 
0d00: 64 65 74 65 72 6d 69 6e 65 64 0a 62 79 20 66 6c  determined.by fl
0d10: 61 67 73 20 67 69 76 65 6e 20 61 73 20 74 68 65  ags given as the
0d20: 20 74 68 69 72 64 20 61 72 67 75 6d 65 6e 74 20   third argument 
0d30: 74 6f 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e  to [sqlite3_open
0d40: 5f 76 32 28 29 5d 2e 20 20 54 68 65 0a 5b 53 51  _v2()].  The.[SQ
0d50: 4c 49 54 45 5f 4f 50 45 4e 5f 4e 4f 4d 55 54 45  LITE_OPEN_NOMUTE
0d60: 58 5d 20 66 6c 61 67 20 63 61 75 73 65 73 20 74  X] flag causes t
0d70: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  he database conn
0d80: 65 63 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 20  ection to be in 
0d90: 74 68 65 0a 6d 75 6c 74 69 2d 74 68 72 65 61 64  the.multi-thread
0da0: 20 6d 6f 64 65 20 61 6e 64 20 74 68 65 20 5b 53   mode and the [S
0db0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 46 55 4c 4c 4d  QLITE_OPEN_FULLM
0dc0: 55 54 45 58 5d 20 66 6c 61 67 20 63 61 75 73 65  UTEX] flag cause
0dd0: 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  s the connection
0de0: 0a 74 6f 20 62 65 20 69 6e 20 73 65 72 69 61 6c  .to be in serial
0df0: 69 7a 65 64 20 6d 6f 64 65 2e 20 20 49 66 20 6e  ized mode.  If n
0e00: 65 69 74 68 65 72 20 66 6c 61 67 20 69 73 20 73  either flag is s
0e10: 70 65 63 69 66 69 65 64 20 6f 72 20 69 66 0a 5b  pecified or if.[
0e20: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 28 29 5d 20  sqlite3_open()] 
0e30: 6f 72 20 5b 73 71 6c 69 74 65 33 5f 6f 70 65 6e  or [sqlite3_open
0e40: 31 36 28 29 5d 20 61 72 65 20 75 73 65 64 20 69  16()] are used i
0e50: 6e 73 74 65 61 64 20 6f 66 20 0a 5b 73 71 6c 69  nstead of .[sqli
0e60: 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 5d 2c 20  te3_open_v2()], 
0e70: 74 68 65 6e 20 74 68 65 20 64 65 66 61 75 6c 74  then the default
0e80: 0a 6d 6f 64 65 20 64 65 74 65 72 6d 69 6e 65 64  .mode determined
0e90: 20 62 79 20 74 68 65 20 63 6f 6d 70 69 6c 65 2d   by the compile-
0ea0: 74 69 6d 65 20 61 6e 64 20 73 74 61 72 74 2d 74  time and start-t
0eb0: 69 6d 65 20 73 65 74 74 69 6e 67 73 20 69 73 20  ime settings is 
0ec0: 75 73 65 64 2e 0a 3c 2f 70 3e 0a                 used..</p>.