/ Hex Artifact Content
Login

Artifact 63045871564085669b5cb1fb92e6efc2e1b1120a:


0000: 0a 23 69 66 6e 64 65 66 20 5f 5f 53 51 4c 49 54  .#ifndef __SQLIT
0010: 45 53 45 53 53 49 4f 4e 5f 48 5f 0a 23 64 65 66  ESESSION_H_.#def
0020: 69 6e 65 20 5f 5f 53 51 4c 49 54 45 53 45 53 53  ine __SQLITESESS
0030: 49 4f 4e 5f 48 5f 20 31 0a 0a 2f 2a 0a 2a 2a 20  ION_H_ 1../*.** 
0040: 4d 61 6b 65 20 73 75 72 65 20 77 65 20 63 61 6e  Make sure we can
0050: 20 63 61 6c 6c 20 74 68 69 73 20 73 74 75 66 66   call this stuff
0060: 20 66 72 6f 6d 20 43 2b 2b 2e 0a 2a 2f 0a 23 69   from C++..*/.#i
0070: 66 64 65 66 20 5f 5f 63 70 6c 75 73 70 6c 75 73  fdef __cplusplus
0080: 0a 65 78 74 65 72 6e 20 22 43 22 20 7b 0a 23 65  .extern "C" {.#e
0090: 6e 64 69 66 0a 0a 23 69 6e 63 6c 75 64 65 20 22  ndif..#include "
00a0: 73 71 6c 69 74 65 33 2e 68 22 0a 0a 74 79 70 65  sqlite3.h"..type
00b0: 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69 74  def struct sqlit
00c0: 65 33 5f 73 65 73 73 69 6f 6e 20 73 71 6c 69 74  e3_session sqlit
00d0: 65 33 5f 73 65 73 73 69 6f 6e 3b 0a 74 79 70 65  e3_session;.type
00e0: 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69 74  def struct sqlit
00f0: 65 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65  e3_changeset_ite
0100: 72 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65  r sqlite3_change
0110: 73 65 74 5f 69 74 65 72 3b 0a 0a 2f 2a 0a 2a 2a  set_iter;../*.**
0120: 20 43 72 65 61 74 65 20 61 20 6e 65 77 20 73 65   Create a new se
0130: 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 61 74 74  ssion object att
0140: 61 63 68 65 64 20 74 6f 20 64 61 74 61 62 61 73  ached to databas
0150: 65 20 68 61 6e 64 6c 65 20 64 62 2e 20 49 66 20  e handle db. If 
0160: 73 75 63 63 65 73 73 66 75 6c 2c 0a 2a 2a 20 61  successful,.** a
0170: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
0180: 6e 65 77 20 6f 62 6a 65 63 74 20 69 73 20 77 72  new object is wr
0190: 69 74 74 65 6e 20 74 6f 20 2a 70 70 53 65 73 73  itten to *ppSess
01a0: 69 6f 6e 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f  ion and SQLITE_O
01b0: 4b 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64  K is.** returned
01c0: 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63  . If an error oc
01d0: 63 75 72 73 2c 20 2a 70 70 53 65 73 73 69 6f 6e  curs, *ppSession
01e0: 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20   is set to NULL 
01f0: 61 6e 64 20 61 6e 20 53 51 4c 69 74 65 0a 2a 2a  and an SQLite.**
0200: 20 65 72 72 6f 72 20 63 6f 64 65 20 28 65 2e 67   error code (e.g
0210: 2e 20 5b 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5d  . [SQLITE_NOMEM]
0220: 29 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  ) is returned..*
0230: 2a 0a 2a 2a 20 49 74 20 69 73 20 70 6f 73 73 69  *.** It is possi
0240: 62 6c 65 20 74 6f 20 63 72 65 61 74 65 20 6d 75  ble to create mu
0250: 6c 74 69 70 6c 65 20 73 65 73 73 69 6f 6e 20 6f  ltiple session o
0260: 62 6a 65 63 74 73 20 61 74 74 61 63 68 65 64 20  bjects attached 
0270: 74 6f 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 64  to a single.** d
0280: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a  atabase handle..
0290: 2a 2a 0a 2a 2a 20 53 65 73 73 69 6f 6e 20 6f 62  **.** Session ob
02a0: 6a 65 63 74 73 20 63 72 65 61 74 65 64 20 75 73  jects created us
02b0: 69 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f  ing this functio
02c0: 6e 20 73 68 6f 75 6c 64 20 62 65 20 64 65 6c 65  n should be dele
02d0: 74 65 64 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a  ted using the.**
02e0: 20 5b 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e   [sqlite3session
02f0: 5f 64 65 6c 65 74 65 28 29 5d 20 66 75 6e 63 74  _delete()] funct
0300: 69 6f 6e 20 62 65 66 6f 72 65 20 74 68 65 20 64  ion before the d
0310: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74  atabase handle t
0320: 68 61 74 20 74 68 65 79 0a 2a 2a 20 61 72 65 20  hat they.** are 
0330: 61 74 74 61 63 68 65 64 20 74 6f 20 69 73 20 69  attached to is i
0340: 74 73 65 6c 66 20 63 6c 6f 73 65 64 2e 20 49 66  tself closed. If
0350: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
0360: 6e 64 6c 65 20 69 73 20 63 6c 6f 73 65 64 20 62  ndle is closed b
0370: 65 66 6f 72 65 0a 2a 2a 20 74 68 65 20 73 65 73  efore.** the ses
0380: 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73 20 64  sion object is d
0390: 65 6c 65 74 65 64 2c 20 74 68 65 6e 20 74 68 65  eleted, then the
03a0: 20 72 65 73 75 6c 74 73 20 6f 66 20 63 61 6c 6c   results of call
03b0: 69 6e 67 20 61 6e 79 20 73 65 73 73 69 6f 6e 0a  ing any session.
03c0: 2a 2a 20 6d 6f 64 75 6c 65 20 66 75 6e 63 74 69  ** module functi
03d0: 6f 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20 5b 73  on, including [s
03e0: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 64 65  qlite3session_de
03f0: 6c 65 74 65 28 29 5d 20 6f 6e 20 74 68 65 20 73  lete()] on the s
0400: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 0a 2a 2a  ession object.**
0410: 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a   are undefined..
0420: 2a 2a 0a 2a 2a 20 42 65 63 61 75 73 65 20 74 68  **.** Because th
0430: 65 20 73 65 73 73 69 6f 6e 20 6d 6f 64 75 6c 65  e session module
0440: 20 75 73 65 73 20 74 68 65 20 5b 73 71 6c 69 74   uses the [sqlit
0450: 65 33 5f 70 72 65 75 70 64 61 74 65 5f 68 6f 6f  e3_preupdate_hoo
0460: 6b 28 29 5d 20 41 50 49 2c 20 69 74 0a 2a 2a 20  k()] API, it.** 
0470: 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20  is not possible 
0480: 66 6f 72 20 61 6e 20 61 70 70 6c 69 63 61 74 69  for an applicati
0490: 6f 6e 20 74 6f 20 72 65 67 69 73 74 65 72 20 61  on to register a
04a0: 20 70 72 65 2d 75 70 64 61 74 65 20 68 6f 6f 6b   pre-update hook
04b0: 20 6f 6e 20 61 0a 2a 2a 20 64 61 74 61 62 61 73   on a.** databas
04c0: 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 68 61  e handle that ha
04d0: 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 73 65  s one or more se
04e0: 73 73 69 6f 6e 20 6f 62 6a 65 63 74 73 20 61 74  ssion objects at
04f0: 74 61 63 68 65 64 2e 20 4e 6f 72 20 69 73 0a 2a  tached. Nor is.*
0500: 2a 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f  * it possible to
0510: 20 63 72 65 61 74 65 20 61 20 73 65 73 73 69 6f   create a sessio
0520: 6e 20 6f 62 6a 65 63 74 20 61 74 74 61 63 68 65  n object attache
0530: 64 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20  d to a database 
0540: 68 61 6e 64 6c 65 20 66 6f 72 0a 2a 2a 20 77 68  handle for.** wh
0550: 69 63 68 20 61 20 70 72 65 2d 75 70 64 61 74 65  ich a pre-update
0560: 20 68 6f 6f 6b 20 69 73 20 61 6c 72 65 61 64 79   hook is already
0570: 20 64 65 66 69 6e 65 64 2e 20 54 68 65 20 72 65   defined. The re
0580: 73 75 6c 74 73 20 6f 66 20 61 74 74 65 6d 70 74  sults of attempt
0590: 69 6e 67 20 0a 2a 2a 20 65 69 74 68 65 72 20 6f  ing .** either o
05a0: 66 20 74 68 65 73 65 20 74 68 69 6e 67 73 20 61  f these things a
05b0: 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a  re undefined..**
05c0: 0a 2a 2a 20 54 68 65 20 73 65 73 73 69 6f 6e 20  .** The session 
05d0: 6f 62 6a 65 63 74 20 77 69 6c 6c 20 62 65 20 75  object will be u
05e0: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 63 68  sed to create ch
05f0: 61 6e 67 65 73 65 74 73 20 66 6f 72 20 74 61 62  angesets for tab
0600: 6c 65 73 20 69 6e 0a 2a 2a 20 64 61 74 61 62 61  les in.** databa
0610: 73 65 20 7a 44 62 2c 20 77 68 65 72 65 20 7a 44  se zDb, where zD
0620: 62 20 69 73 20 65 69 74 68 65 72 20 22 6d 61 69  b is either "mai
0630: 6e 22 2c 20 6f 72 20 22 74 65 6d 70 22 2c 20 6f  n", or "temp", o
0640: 72 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 6e  r the name of an
0650: 0a 2a 2a 20 61 74 74 61 63 68 65 64 20 64 61 74  .** attached dat
0660: 61 62 61 73 65 2e 20 49 74 20 69 73 20 6e 6f 74  abase. It is not
0670: 20 61 6e 20 65 72 72 6f 72 20 69 66 20 64 61 74   an error if dat
0680: 61 62 61 73 65 20 7a 44 62 20 64 6f 65 73 20 6e  abase zDb does n
0690: 6f 74 20 65 78 69 73 74 0a 2a 2a 20 74 6f 20 74  ot exist.** to t
06a0: 68 65 20 64 61 74 61 62 61 73 65 20 77 68 65 6e  he database when
06b0: 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62 6a   the session obj
06c0: 65 63 74 20 69 73 20 63 72 65 61 74 65 64 2e 0a  ect is created..
06d0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 73 65  */.int sqlite3se
06e0: 73 73 69 6f 6e 5f 63 72 65 61 74 65 28 0a 20 20  ssion_create(.  
06f0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
0700: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0710: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
0720: 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  le */.  const ch
0730: 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 20 20 20  ar *zDb,        
0740: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20          /* Name 
0750: 6f 66 20 64 62 20 28 65 2e 67 2e 20 22 6d 61 69  of db (e.g. "mai
0760: 6e 22 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  n") */.  sqlite3
0770: 5f 73 65 73 73 69 6f 6e 20 2a 2a 70 70 53 65 73  _session **ppSes
0780: 73 69 6f 6e 20 20 20 20 20 2f 2a 20 4f 55 54 3a  sion     /* OUT:
0790: 20 4e 65 77 20 73 65 73 73 69 6f 6e 20 6f 62 6a   New session obj
07a0: 65 63 74 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a  ect */.);../*.**
07b0: 20 44 65 6c 65 74 65 20 61 20 73 65 73 73 69 6f   Delete a sessio
07c0: 6e 20 6f 62 6a 65 63 74 20 70 72 65 76 69 6f 75  n object previou
07d0: 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 75 73  sly allocated us
07e0: 69 6e 67 20 0a 2a 2a 20 5b 73 71 6c 69 74 65 33  ing .** [sqlite3
07f0: 73 65 73 73 69 6f 6e 5f 63 72 65 61 74 65 28 29  session_create()
0800: 5d 2e 20 4f 6e 63 65 20 61 20 73 65 73 73 69 6f  ]. Once a sessio
0810: 6e 20 6f 62 6a 65 63 74 20 68 61 73 20 62 65 65  n object has bee
0820: 6e 20 64 65 6c 65 74 65 64 2c 20 74 68 65 0a 2a  n deleted, the.*
0830: 2a 20 72 65 73 75 6c 74 73 20 6f 66 20 61 74 74  * results of att
0840: 65 6d 70 74 69 6e 67 20 74 6f 20 75 73 65 20 70  empting to use p
0850: 53 65 73 73 69 6f 6e 20 77 69 74 68 20 61 6e 79  Session with any
0860: 20 6f 74 68 65 72 20 73 65 73 73 69 6f 6e 20 6d   other session m
0870: 6f 64 75 6c 65 0a 2a 2a 20 66 75 6e 63 74 69 6f  odule.** functio
0880: 6e 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e  n are undefined.
0890: 0a 2a 2a 0a 2a 2a 20 53 65 73 73 69 6f 6e 20 6f  .**.** Session o
08a0: 62 6a 65 63 74 73 20 6d 75 73 74 20 62 65 20 64  bjects must be d
08b0: 65 6c 65 74 65 64 20 62 65 66 6f 72 65 20 74 68  eleted before th
08c0: 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  e database handl
08d0: 65 20 74 6f 20 77 68 69 63 68 20 74 68 65 79 0a  e to which they.
08e0: 2a 2a 20 61 72 65 20 61 74 74 61 63 68 65 64 20  ** are attached 
08f0: 69 73 20 63 6c 6f 73 65 64 2e 20 52 65 66 65 72  is closed. Refer
0900: 20 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e 74   to the document
0910: 61 74 69 6f 6e 20 66 6f 72 20 0a 2a 2a 20 5b 73  ation for .** [s
0920: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63 72  qlite3session_cr
0930: 65 61 74 65 28 29 5d 20 66 6f 72 20 64 65 74 61  eate()] for deta
0940: 69 6c 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ils..*/.void sql
0950: 69 74 65 33 73 65 73 73 69 6f 6e 5f 64 65 6c 65  ite3session_dele
0960: 74 65 28 73 71 6c 69 74 65 33 5f 73 65 73 73 69  te(sqlite3_sessi
0970: 6f 6e 20 2a 70 53 65 73 73 69 6f 6e 29 3b 0a 0a  on *pSession);..
0980: 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20  /*.** Enable or 
0990: 64 69 73 61 62 6c 65 20 74 68 65 20 72 65 63 6f  disable the reco
09a0: 72 64 69 6e 67 20 6f 66 20 63 68 61 6e 67 65 73  rding of changes
09b0: 20 62 79 20 61 20 73 65 73 73 69 6f 6e 20 6f 62   by a session ob
09c0: 6a 65 63 74 2e 20 57 68 65 6e 0a 2a 2a 20 65 6e  ject. When.** en
09d0: 61 62 6c 65 64 2c 20 61 20 73 65 73 73 69 6f 6e  abled, a session
09e0: 20 6f 62 6a 65 63 74 20 72 65 63 6f 72 64 73 20   object records 
09f0: 63 68 61 6e 67 65 73 20 6d 61 64 65 20 74 6f 20  changes made to 
0a00: 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 57 68  the database. Wh
0a10: 65 6e 0a 2a 2a 20 64 69 73 61 62 6c 65 64 20 2d  en.** disabled -
0a20: 20 69 74 20 64 6f 65 73 20 6e 6f 74 2e 20 41 20   it does not. A 
0a30: 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 73 65  newly created se
0a40: 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73 20  ssion object is 
0a50: 65 6e 61 62 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 50  enabled..**.** P
0a60: 61 73 73 69 6e 67 20 7a 65 72 6f 20 74 6f 20 74  assing zero to t
0a70: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 69 73  his function dis
0a80: 61 62 6c 65 73 20 74 68 65 20 73 65 73 73 69 6f  ables the sessio
0a90: 6e 2e 20 50 61 73 73 69 6e 67 20 61 20 76 61 6c  n. Passing a val
0aa0: 75 65 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68  ue.** greater th
0ab0: 61 6e 20 7a 65 72 6f 20 65 6e 61 62 6c 65 73 20  an zero enables 
0ac0: 69 74 2e 20 50 61 73 73 69 6e 67 20 61 20 76 61  it. Passing a va
0ad0: 6c 75 65 20 6c 65 73 73 20 74 68 61 6e 20 7a 65  lue less than ze
0ae0: 72 6f 20 69 73 20 61 20 0a 2a 2a 20 6e 6f 2d 6f  ro is a .** no-o
0af0: 70 2c 20 61 6e 64 20 6d 61 79 20 62 65 20 75 73  p, and may be us
0b00: 65 64 20 74 6f 20 71 75 65 72 79 20 74 68 65 20  ed to query the 
0b10: 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66  current state of
0b20: 20 74 68 65 20 73 65 73 73 69 6f 6e 2e 0a 2a 2a   the session..**
0b30: 0a 2a 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76  .** The return v
0b40: 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 20 74  alue indicates t
0b50: 68 65 20 66 69 6e 61 6c 20 73 74 61 74 65 20 6f  he final state o
0b60: 66 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62  f the session ob
0b70: 6a 65 63 74 3a 20 30 20 69 66 20 0a 2a 2a 20 74  ject: 0 if .** t
0b80: 68 65 20 73 65 73 73 69 6f 6e 20 69 73 20 64 69  he session is di
0b90: 73 61 62 6c 65 64 2c 20 6f 72 20 31 20 69 66 20  sabled, or 1 if 
0ba0: 69 74 20 69 73 20 65 6e 61 62 6c 65 64 2e 0a 2a  it is enabled..*
0bb0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 73 65 73  /.int sqlite3ses
0bc0: 73 69 6f 6e 5f 65 6e 61 62 6c 65 28 73 71 6c 69  sion_enable(sqli
0bd0: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65  te3_session *pSe
0be0: 73 73 69 6f 6e 2c 20 69 6e 74 20 62 45 6e 61 62  ssion, int bEnab
0bf0: 6c 65 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 61  le);../*.** Atta
0c00: 63 68 20 61 20 74 61 62 6c 65 20 74 6f 20 61 20  ch a table to a 
0c10: 73 65 73 73 69 6f 6e 2e 20 41 6c 6c 20 73 75 62  session. All sub
0c20: 73 65 71 75 65 6e 74 20 63 68 61 6e 67 65 73 20  sequent changes 
0c30: 6d 61 64 65 20 74 6f 20 74 68 65 20 74 61 62 6c  made to the tabl
0c40: 65 0a 2a 2a 20 77 68 69 6c 65 20 74 68 65 20 73  e.** while the s
0c50: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73  ession object is
0c60: 20 65 6e 61 62 6c 65 64 20 77 69 6c 6c 20 62 65   enabled will be
0c70: 20 72 65 63 6f 72 64 65 64 2e 0a 2a 2a 0a 2a 2a   recorded..**.**
0c80: 20 4f 6e 6c 79 20 74 61 62 6c 65 73 20 74 68 61   Only tables tha
0c90: 74 20 68 61 76 65 20 61 20 50 52 49 4d 41 52 59  t have a PRIMARY
0ca0: 20 4b 45 59 20 64 65 66 69 6e 65 64 20 6d 61 79   KEY defined may
0cb0: 20 62 65 20 61 74 74 61 63 68 65 64 2e 20 49 74   be attached. It
0cc0: 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 6d 61 74   does.** not mat
0cd0: 74 65 72 20 69 66 20 74 68 65 20 50 52 49 4d 41  ter if the PRIMA
0ce0: 52 59 20 4b 45 59 20 69 73 20 61 6e 20 22 49 4e  RY KEY is an "IN
0cf0: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45  TEGER PRIMARY KE
0d00: 59 22 20 28 72 6f 77 69 64 20 61 6c 69 61 73 29  Y" (rowid alias)
0d10: 0a 2a 2a 20 6f 72 20 6e 6f 74 2e 0a 2a 2f 0a 69  .** or not..*/.i
0d20: 6e 74 20 73 71 6c 69 74 65 33 73 65 73 73 69 6f  nt sqlite3sessio
0d30: 6e 5f 61 74 74 61 63 68 28 0a 20 20 73 71 6c 69  n_attach(.  sqli
0d40: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65  te3_session *pSe
0d50: 73 73 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53  ssion,      /* S
0d60: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f  ession object */
0d70: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
0d80: 54 61 62 20 20 20 20 20 20 20 20 20 20 20 20 20  Tab             
0d90: 20 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65     /* Table name
0da0: 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4f 62   */.);../*.** Ob
0db0: 74 61 69 6e 20 61 20 63 68 61 6e 67 65 73 65 74  tain a changeset
0dc0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 63 68 61 6e   containing chan
0dd0: 67 65 73 20 74 6f 20 74 68 65 20 74 61 62 6c 65  ges to the table
0de0: 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 68  s attached to th
0df0: 65 20 0a 2a 2a 20 73 65 73 73 69 6f 6e 20 6f 62  e .** session ob
0e00: 6a 65 63 74 20 70 61 73 73 65 64 20 61 73 20 74  ject passed as t
0e10: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e  he first argumen
0e20: 74 2e 20 49 66 20 73 75 63 63 65 73 73 66 75 6c  t. If successful
0e30: 2c 20 0a 2a 2a 20 73 65 74 20 2a 70 70 43 68 61  , .** set *ppCha
0e40: 6e 67 65 73 65 74 20 74 6f 20 70 6f 69 6e 74 20  ngeset to point 
0e50: 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f 6e 74  to a buffer cont
0e60: 61 69 6e 69 6e 67 20 74 68 65 20 63 68 61 6e 67  aining the chang
0e70: 65 73 65 74 20 0a 2a 2a 20 61 6e 64 20 2a 70 6e  eset .** and *pn
0e80: 43 68 61 6e 67 65 73 65 74 20 74 6f 20 74 68 65  Changeset to the
0e90: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 63 68 61   size of the cha
0ea0: 6e 67 65 73 65 74 20 69 6e 20 62 79 74 65 73 20  ngeset in bytes 
0eb0: 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67  before returning
0ec0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49  .** SQLITE_OK. I
0ed0: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
0ee0: 73 2c 20 73 65 74 20 62 6f 74 68 20 2a 70 70 43  s, set both *ppC
0ef0: 68 61 6e 67 65 73 65 74 20 61 6e 64 20 2a 70 6e  hangeset and *pn
0f00: 43 68 61 6e 67 65 73 65 74 20 74 6f 0a 2a 2a 20  Changeset to.** 
0f10: 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 20  zero and return 
0f20: 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20  an SQLite error 
0f30: 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 6c 6c  code..**.** Foll
0f40: 6f 77 69 6e 67 20 61 20 73 75 63 63 65 73 73 66  owing a successf
0f50: 75 6c 20 63 61 6c 6c 20 74 6f 20 74 68 69 73 20  ul call to this 
0f60: 66 75 6e 63 74 69 6f 6e 2c 20 69 74 20 69 73 20  function, it is 
0f70: 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69  the responsibili
0f80: 74 79 20 6f 66 0a 2a 2a 20 74 68 65 20 63 61 6c  ty of.** the cal
0f90: 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c  ler to eventuall
0fa0: 79 20 66 72 65 65 20 74 68 65 20 62 75 66 66 65  y free the buffe
0fb0: 72 20 74 68 61 74 20 2a 70 70 43 68 61 6e 67 65  r that *ppChange
0fc0: 73 65 74 20 70 6f 69 6e 74 73 20 74 6f 20 75 73  set points to us
0fd0: 69 6e 67 0a 2a 2a 20 5b 73 71 6c 69 74 65 33 5f  ing.** [sqlite3_
0fe0: 66 72 65 65 28 29 5d 2e 0a 2a 2f 0a 69 6e 74 20  free()]..*/.int 
0ff0: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63  sqlite3session_c
1000: 68 61 6e 67 65 73 65 74 28 0a 20 20 73 71 6c 69  hangeset(.  sqli
1010: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65  te3_session *pSe
1020: 73 73 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53  ssion,      /* S
1030: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f  ession object */
1040: 0a 20 20 69 6e 74 20 2a 70 6e 43 68 61 6e 67 65  .  int *pnChange
1050: 73 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20  set,            
1060: 20 20 20 2f 2a 20 4f 55 54 3a 20 53 69 7a 65 20     /* OUT: Size 
1070: 6f 66 20 62 75 66 66 65 72 20 61 74 20 2a 70 70  of buffer at *pp
1080: 43 68 61 6e 67 65 73 65 74 20 2a 2f 0a 20 20 76  Changeset */.  v
1090: 6f 69 64 20 2a 2a 70 70 43 68 61 6e 67 65 73 65  oid **ppChangese
10a0: 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  t              /
10b0: 2a 20 4f 55 54 3a 20 42 75 66 66 65 72 20 63 6f  * OUT: Buffer co
10c0: 6e 74 61 69 6e 69 6e 67 20 63 68 61 6e 67 65 73  ntaining changes
10d0: 65 74 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20  et */.);../*.** 
10e0: 43 72 65 61 74 65 20 61 6e 20 69 74 65 72 61 74  Create an iterat
10f0: 6f 72 20 75 73 65 64 20 74 6f 20 69 74 65 72 61  or used to itera
1100: 74 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 63  te through the c
1110: 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 63 68 61  ontents of a cha
1120: 6e 67 65 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73  ngeset..*/.int s
1130: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
1140: 73 74 61 72 74 28 0a 20 20 73 71 6c 69 74 65 33  start(.  sqlite3
1150: 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72 20  _changeset_iter 
1160: 2a 2a 70 70 49 74 65 72 2c 0a 20 20 69 6e 74 20  **ppIter,.  int 
1170: 6e 43 68 61 6e 67 65 73 65 74 2c 20 0a 20 20 76  nChangeset, .  v
1180: 6f 69 64 20 2a 70 43 68 61 6e 67 65 73 65 74 0a  oid *pChangeset.
1190: 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 6e 63  );../*.** Advanc
11a0: 65 20 61 6e 20 69 74 65 72 61 74 6f 72 20 63 72  e an iterator cr
11b0: 65 61 74 65 64 20 62 79 20 73 71 6c 69 74 65 33  eated by sqlite3
11c0: 63 68 61 6e 67 65 73 65 74 5f 73 74 61 72 74 28  changeset_start(
11d0: 29 20 74 6f 20 74 68 65 20 6e 65 78 74 0a 2a 2a  ) to the next.**
11e0: 20 63 68 61 6e 67 65 20 69 6e 20 74 68 65 20 63   change in the c
11f0: 68 61 6e 67 65 73 65 74 2e 20 54 68 69 73 20 66  hangeset. This f
1200: 75 6e 63 74 69 6f 6e 20 6d 61 79 20 72 65 74 75  unction may retu
1210: 72 6e 20 53 51 4c 49 54 45 5f 52 4f 57 2c 20 53  rn SQLITE_ROW, S
1220: 51 4c 49 54 45 5f 44 4f 4e 45 0a 2a 2a 20 6f 72  QLITE_DONE.** or
1230: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e   SQLITE_CORRUPT.
1240: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  .**.** This func
1250: 74 69 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 65 20  tion may not be 
1260: 63 61 6c 6c 65 64 20 6f 6e 20 69 74 65 72 61 74  called on iterat
1270: 6f 72 73 20 70 61 73 73 65 64 20 74 6f 20 61 20  ors passed to a 
1280: 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65 72  conflict handler
1290: 0a 2a 2a 20 63 61 6c 6c 62 61 63 6b 20 62 79 20  .** callback by 
12a0: 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28  changeset_apply(
12b0: 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  )..*/.int sqlite
12c0: 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 78 74 28  3changeset_next(
12d0: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 65  sqlite3_changese
12e0: 74 5f 69 74 65 72 20 2a 70 49 74 65 72 29 3b 0a  t_iter *pIter);.
12f0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f  ./*.** The follo
1300: 77 69 6e 67 20 74 68 72 65 65 20 66 75 6e 63 74  wing three funct
1310: 69 6f 6e 73 20 65 78 74 72 61 63 74 20 69 6e 66  ions extract inf
1320: 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20  ormation on the 
1330: 63 75 72 72 65 6e 74 20 63 68 61 6e 67 65 0a 2a  current change.*
1340: 2a 20 66 72 6f 6d 20 61 20 63 68 61 6e 67 65 73  * from a changes
1350: 65 74 20 69 74 65 72 61 74 6f 72 2e 20 54 68 65  et iterator. The
1360: 79 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61  y may only be ca
1370: 6c 6c 65 64 20 61 66 74 65 72 20 63 68 61 6e 67  lled after chang
1380: 65 73 65 74 5f 6e 65 78 74 28 29 0a 2a 2a 20 68  eset_next().** h
1390: 61 73 20 72 65 74 75 72 6e 65 64 20 53 51 4c 49  as returned SQLI
13a0: 54 45 5f 52 4f 57 2e 0a 2a 2f 0a 69 6e 74 20 73  TE_ROW..*/.int s
13b0: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
13c0: 6f 70 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 68  op(.  sqlite3_ch
13d0: 61 6e 67 65 73 65 74 5f 69 74 65 72 20 2a 70 49  angeset_iter *pI
13e0: 74 65 72 2c 20 20 2f 2a 20 49 74 65 72 61 74 6f  ter,  /* Iterato
13f0: 72 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 63 6f  r object */.  co
1400: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 62  nst char **pzTab
1410: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ,             /*
1420: 20 4f 55 54 3a 20 50 6f 69 6e 74 65 72 20 74 6f   OUT: Pointer to
1430: 20 74 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20   table name */. 
1440: 20 69 6e 74 20 2a 70 6e 43 6f 6c 2c 20 20 20 20   int *pnCol,    
1450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1460: 20 2f 2a 20 4f 55 54 3a 20 4e 75 6d 62 65 72 20   /* OUT: Number 
1470: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 61  of columns in ta
1480: 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4f  ble */.  int *pO
1490: 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p               
14a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
14b0: 20 53 51 4c 49 54 45 5f 49 4e 53 45 52 54 2c 20   SQLITE_INSERT, 
14c0: 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54 45  DELETE or UPDATE
14d0: 20 2a 2f 0a 29 3b 0a 69 6e 74 20 73 71 6c 69 74   */.);.int sqlit
14e0: 65 33 63 68 61 6e 67 65 73 65 74 5f 6f 6c 64 28  e3changeset_old(
14f0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67  .  sqlite3_chang
1500: 65 73 65 74 5f 69 74 65 72 20 2a 70 49 74 65 72  eset_iter *pIter
1510: 2c 20 20 2f 2a 20 43 68 61 6e 67 65 73 65 74 20  ,  /* Changeset 
1520: 69 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 69 6e  iterator */.  in
1530: 74 20 69 56 61 6c 2c 20 20 20 20 20 20 20 20 20  t iVal,         
1540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1550: 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 2a   Column number *
1560: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  /.  sqlite3_valu
1570: 65 20 2a 2a 70 70 56 61 6c 75 65 20 20 20 20 20  e **ppValue     
1580: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4f 6c 64 20      /* OUT: Old 
1590: 76 61 6c 75 65 20 28 6f 72 20 4e 55 4c 4c 20 70  value (or NULL p
15a0: 6f 69 6e 74 65 72 29 20 2a 2f 0a 29 3b 0a 69 6e  ointer) */.);.in
15b0: 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73  t sqlite3changes
15c0: 65 74 5f 6e 65 77 28 0a 20 20 73 71 6c 69 74 65  et_new(.  sqlite
15d0: 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72  3_changeset_iter
15e0: 20 2a 70 49 74 65 72 2c 20 20 2f 2a 20 43 68 61   *pIter,  /* Cha
15f0: 6e 67 65 73 65 74 20 69 74 65 72 61 74 6f 72 20  ngeset iterator 
1600: 2a 2f 0a 20 20 69 6e 74 20 69 56 61 6c 2c 20 20  */.  int iVal,  
1610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1620: 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e       /* Column n
1630: 75 6d 62 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74  umber */.  sqlit
1640: 65 33 5f 76 61 6c 75 65 20 2a 2a 70 70 56 61 6c  e3_value **ppVal
1650: 75 65 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55  ue         /* OU
1660: 54 3a 20 4e 65 77 20 76 61 6c 75 65 20 28 6f 72  T: New value (or
1670: 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 29 20 2a   NULL pointer) *
1680: 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  /.);../*.** This
1690: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c   function is onl
16a0: 79 20 75 73 61 62 6c 65 20 77 69 74 68 20 73 71  y usable with sq
16b0: 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 65 74 5f  lite3_changeset_
16c0: 69 74 65 72 20 6f 62 6a 65 63 74 73 20 70 61 73  iter objects pas
16d0: 73 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 78 43  sed.** to the xC
16e0: 6f 6e 66 6c 69 63 74 20 63 61 6c 6c 62 61 63 6b  onflict callback
16f0: 20 62 79 20 73 71 6c 69 74 65 33 63 68 61 6e 67   by sqlite3chang
1700: 65 73 65 74 5f 61 70 70 6c 79 28 29 2e 20 49 74  eset_apply(). It
1710: 20 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 0a   cannot be used.
1720: 2a 2a 20 77 69 74 68 20 69 74 65 72 61 74 6f 72  ** with iterator
1730: 73 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20  s created using 
1740: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74  sqlite3changeset
1750: 5f 73 74 61 72 74 28 29 2e 0a 2a 2a 0a 2a 2a 20  _start()..**.** 
1760: 49 74 20 69 73 20 75 73 65 64 20 74 6f 20 61 63  It is used to ac
1770: 63 65 73 73 20 74 68 65 20 22 63 6f 6e 66 6c 69  cess the "confli
1780: 63 74 69 6e 67 20 72 6f 77 22 20 69 6e 66 6f 72  cting row" infor
1790: 6d 61 74 69 6f 6e 20 61 76 61 69 6c 61 62 6c 65  mation available
17a0: 20 74 6f 20 74 68 65 0a 2a 2a 20 63 6f 6e 66 6c   to the.** confl
17b0: 69 63 74 20 68 61 6e 64 6c 65 72 20 69 66 20 74  ict handler if t
17c0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
17d0: 6e 74 20 69 73 20 65 69 74 68 65 72 20 53 51 4c  nt is either SQL
17e0: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44 41  ITE_CHANGESET_DA
17f0: 54 41 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45 5f  TA.** or SQLITE_
1800: 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49  CHANGESET_CONFLI
1810: 43 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  CT..*/.int sqlit
1820: 65 33 63 68 61 6e 67 65 73 65 74 5f 63 6f 6e 66  e3changeset_conf
1830: 6c 69 63 74 28 0a 20 20 73 71 6c 69 74 65 33 5f  lict(.  sqlite3_
1840: 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72 20 2a  changeset_iter *
1850: 70 49 74 65 72 2c 20 20 2f 2a 20 43 68 61 6e 67  pIter,  /* Chang
1860: 65 73 65 74 20 69 74 65 72 61 74 6f 72 20 2a 2f  eset iterator */
1870: 0a 20 20 69 6e 74 20 69 56 61 6c 2c 20 20 20 20  .  int iVal,    
1880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1890: 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d     /* Column num
18a0: 62 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ber */.  sqlite3
18b0: 5f 76 61 6c 75 65 20 2a 2a 70 70 56 61 6c 75 65  _value **ppValue
18c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
18d0: 20 56 61 6c 75 65 20 66 72 6f 6d 20 63 6f 6e 66   Value from conf
18e0: 6c 69 63 74 69 6e 67 20 72 6f 77 20 2a 2f 0a 29  licting row */.)
18f0: 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 61 6c 69  ;.../*.** Finali
1900: 7a 65 20 61 6e 20 69 74 65 72 61 74 6f 72 20 61  ze an iterator a
1910: 6c 6c 6f 63 61 74 65 64 20 77 69 74 68 20 73 71  llocated with sq
1920: 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 73  lite3changeset_s
1930: 74 61 72 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68  tart()..**.** Th
1940: 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20  is function may 
1950: 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e  not be called on
1960: 20 69 74 65 72 61 74 6f 72 73 20 70 61 73 73 65   iterators passe
1970: 64 20 74 6f 20 61 20 63 6f 6e 66 6c 69 63 74 20  d to a conflict 
1980: 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c 62  handler.** callb
1990: 61 63 6b 20 62 79 20 63 68 61 6e 67 65 73 65 74  ack by changeset
19a0: 5f 61 70 70 6c 79 28 29 2e 0a 2a 2f 0a 69 6e 74  _apply()..*/.int
19b0: 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65   sqlite3changese
19c0: 74 5f 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74  t_finalize(sqlit
19d0: 65 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65  e3_changeset_ite
19e0: 72 20 2a 70 49 74 65 72 29 3b 0a 0a 2f 2a 0a 2a  r *pIter);../*.*
19f0: 2a 20 49 6e 76 65 72 74 20 61 20 63 68 61 6e 67  * Invert a chang
1a00: 65 73 65 74 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a  eset object..*/.
1a10: 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67  int sqlite3chang
1a20: 65 73 65 74 5f 69 6e 76 65 72 74 28 0a 20 20 69  eset_invert(.  i
1a30: 6e 74 20 6e 49 6e 2c 20 76 6f 69 64 20 2a 70 49  nt nIn, void *pI
1a40: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  n,             /
1a50: 2a 20 49 6e 70 75 74 20 63 68 61 6e 67 65 73 65  * Input changese
1a60: 74 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4f 75  t */.  int *pnOu
1a70: 74 2c 20 76 6f 69 64 20 2a 2a 70 70 4f 75 74 20  t, void **ppOut 
1a80: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 49         /* OUT: I
1a90: 6e 76 65 72 73 65 20 6f 66 20 69 6e 70 75 74 20  nverse of input 
1aa0: 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 70 70  */.);../*.** App
1ab0: 6c 79 20 61 20 63 68 61 6e 67 65 73 65 74 20 74  ly a changeset t
1ac0: 6f 20 61 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a  o a database..**
1ad0: 0a 2a 2a 20 49 74 20 69 73 20 73 61 66 65 20 74  .** It is safe t
1ae0: 6f 20 65 78 65 63 75 74 65 20 53 51 4c 20 73 74  o execute SQL st
1af0: 61 74 65 6d 65 6e 74 73 2c 20 69 6e 63 6c 75 64  atements, includ
1b00: 69 6e 67 20 74 68 6f 73 65 20 74 68 61 74 20 77  ing those that w
1b10: 72 69 74 65 20 74 6f 20 74 68 65 0a 2a 2a 20 74  rite to the.** t
1b20: 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 63 61  able that the ca
1b30: 6c 6c 62 61 63 6b 20 72 65 6c 61 74 65 64 20 74  llback related t
1b40: 6f 2c 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74  o, from within t
1b50: 68 65 20 78 43 6f 6e 66 6c 69 63 74 20 63 61 6c  he xConflict cal
1b60: 6c 62 61 63 6b 2e 0a 2a 2a 20 54 68 69 73 20 63  lback..** This c
1b70: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 66 75  an be used to fu
1b80: 72 74 68 65 72 20 63 75 73 74 6f 6d 69 7a 65 20  rther customize 
1b90: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  the applications
1ba0: 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20 72 65 73   conflict.** res
1bb0: 6f 6c 75 74 69 6f 6e 20 73 74 72 61 74 65 67 79  olution strategy
1bc0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
1bd0: 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28  changeset_apply(
1be0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1c00: 20 20 20 2f 2a 20 41 70 70 6c 79 20 63 68 61 6e     /* Apply chan
1c10: 67 65 20 74 6f 20 22 6d 61 69 6e 22 20 64 62 20  ge to "main" db 
1c20: 6f 66 20 74 68 69 73 20 68 61 6e 64 6c 65 20 2a  of this handle *
1c30: 2f 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67 65 73  /.  int nChanges
1c40: 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  et,             
1c50: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 63      /* Size of c
1c60: 68 61 6e 67 65 73 65 74 20 69 6e 20 62 79 74 65  hangeset in byte
1c70: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 43 68  s */.  void *pCh
1c80: 61 6e 67 65 73 65 74 2c 20 20 20 20 20 20 20 20  angeset,        
1c90: 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e 67 65         /* Change
1ca0: 73 65 74 20 62 6c 6f 62 20 2a 2f 0a 20 20 69 6e  set blob */.  in
1cb0: 74 28 2a 78 43 6f 6e 66 6c 69 63 74 29 28 0a 20  t(*xConflict)(. 
1cc0: 20 20 20 76 6f 69 64 20 2a 70 43 74 78 2c 20 20     void *pCtx,  
1cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ce0: 20 2f 2a 20 43 6f 70 79 20 6f 66 20 66 69 66 74   /* Copy of fift
1cf0: 68 20 61 72 67 20 74 6f 20 5f 61 70 70 6c 79 28  h arg to _apply(
1d00: 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20 65 43 6f  ) */.    int eCo
1d10: 6e 66 6c 69 63 74 2c 20 20 20 20 20 20 20 20 20  nflict,         
1d20: 20 20 20 20 20 20 20 2f 2a 20 44 41 54 41 2c 20         /* DATA, 
1d30: 4d 49 53 53 49 4e 47 2c 20 43 4f 4e 46 4c 49 43  MISSING, CONFLIC
1d40: 54 2c 20 43 4f 4e 53 54 52 41 49 4e 54 20 2a 2f  T, CONSTRAINT */
1d50: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 68 61  .    sqlite3_cha
1d60: 6e 67 65 73 65 74 5f 69 74 65 72 20 2a 70 20 20  ngeset_iter *p  
1d70: 20 20 20 2f 2a 20 48 61 6e 64 6c 65 20 64 65 73     /* Handle des
1d80: 63 72 69 62 69 6e 67 20 63 68 61 6e 67 65 20 61  cribing change a
1d90: 6e 64 20 63 6f 6e 66 6c 69 63 74 20 2a 2f 0a 20  nd conflict */. 
1da0: 20 29 2c 0a 20 20 76 6f 69 64 20 2a 70 43 74 78   ),.  void *pCtx
1db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1dc0: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61        /* First a
1dd0: 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74  rgument passed t
1de0: 6f 20 78 43 6f 6e 66 6c 69 63 74 20 2a 2f 0a 29  o xConflict */.)
1df0: 3b 0a 0a 2f 2a 20 0a 2a 2a 20 56 61 6c 75 65 73  ;../* .** Values
1e00: 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73   passed as the s
1e10: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74  econd argument t
1e20: 6f 20 61 20 63 6f 6e 66 6c 69 63 74 2d 68 61 6e  o a conflict-han
1e30: 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49  dler..**.** SQLI
1e40: 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44 41 54  TE_CHANGESET_DAT
1e50: 41 3a 0a 2a 2a 20 20 20 54 68 65 20 63 6f 6e 66  A:.**   The conf
1e60: 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 69 73 20  lict handler is 
1e70: 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 43 48 41  invoked with CHA
1e80: 4e 47 45 53 45 54 5f 44 41 54 41 20 61 73 20 74  NGESET_DATA as t
1e90: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
1ea0: 6e 74 0a 2a 2a 20 20 20 77 68 65 6e 20 70 72 6f  nt.**   when pro
1eb0: 63 65 73 73 69 6e 67 20 61 20 44 45 4c 45 54 45  cessing a DELETE
1ec0: 20 6f 72 20 55 50 44 41 54 45 20 63 68 61 6e 67   or UPDATE chang
1ed0: 65 20 69 66 20 61 20 72 6f 77 20 77 69 74 68 20  e if a row with 
1ee0: 74 68 65 20 72 65 71 75 69 72 65 64 0a 2a 2a 20  the required.** 
1ef0: 20 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 69    PRIMARY KEY fi
1f00: 65 6c 64 73 20 69 73 20 70 72 65 73 65 6e 74 20  elds is present 
1f10: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2c  in the database,
1f20: 20 62 75 74 20 6f 6e 65 20 6f 72 20 6d 6f 72 65   but one or more
1f30: 20 6f 74 68 65 72 20 0a 2a 2a 20 20 20 28 6e 6f   other .**   (no
1f40: 6e 20 70 72 69 6d 61 72 79 2d 6b 65 79 29 20 66  n primary-key) f
1f50: 69 65 6c 64 73 20 6d 6f 64 69 66 69 65 64 20 62  ields modified b
1f60: 79 20 74 68 65 20 75 70 64 61 74 65 20 64 6f 20  y the update do 
1f70: 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 20  not contain the 
1f80: 0a 2a 2a 20 20 20 65 78 70 65 63 74 65 64 20 22  .**   expected "
1f90: 62 65 66 6f 72 65 22 20 76 61 6c 75 65 73 2e 0a  before" values..
1fa0: 2a 2a 20 0a 2a 2a 20 20 20 54 68 65 20 63 6f 6e  ** .**   The con
1fb0: 66 6c 69 63 74 69 6e 67 20 72 6f 77 2c 20 69 6e  flicting row, in
1fc0: 20 74 68 69 73 20 63 61 73 65 2c 20 69 73 20 74   this case, is t
1fd0: 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 77 20  he database row 
1fe0: 77 69 74 68 20 74 68 65 20 6d 61 74 63 68 69 6e  with the matchin
1ff0: 67 0a 2a 2a 20 20 20 70 72 69 6d 61 72 79 20 6b  g.**   primary k
2000: 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 53 51 4c 49 54  ey..** .** SQLIT
2010: 45 5f 43 48 41 4e 47 45 53 45 54 5f 4e 4f 54 46  E_CHANGESET_NOTF
2020: 4f 55 4e 44 3a 0a 2a 2a 20 20 20 54 68 65 20 63  OUND:.**   The c
2030: 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 20  onflict handler 
2040: 69 73 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20  is invoked with 
2050: 43 48 41 4e 47 45 53 45 54 5f 4e 4f 54 46 4f 55  CHANGESET_NOTFOU
2060: 4e 44 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64  ND as the second
2070: 0a 2a 2a 20 20 20 61 72 67 75 6d 65 6e 74 20 77  .**   argument w
2080: 68 65 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 61  hen processing a
2090: 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54   DELETE or UPDAT
20a0: 45 20 63 68 61 6e 67 65 20 69 66 20 61 20 72 6f  E change if a ro
20b0: 77 20 77 69 74 68 20 74 68 65 0a 2a 2a 20 20 20  w with the.**   
20c0: 72 65 71 75 69 72 65 64 20 50 52 49 4d 41 52 59  required PRIMARY
20d0: 20 4b 45 59 20 66 69 65 6c 64 73 20 69 73 20 6e   KEY fields is n
20e0: 6f 74 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68  ot present in th
20f0: 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 20 0a  e database..** .
2100: 2a 2a 20 20 20 54 68 65 72 65 20 69 73 20 6e 6f  **   There is no
2110: 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77   conflicting row
2120: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 54   in this case. T
2130: 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 69 6e  he results of in
2140: 76 6f 6b 69 6e 67 20 74 68 65 0a 2a 2a 20 20 20  voking the.**   
2150: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74  sqlite3changeset
2160: 5f 63 6f 6e 66 6c 69 63 74 28 29 20 41 50 49 20  _conflict() API 
2170: 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a  are undefined..*
2180: 2a 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 48 41  * .** SQLITE_CHA
2190: 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43 54 3a  NGESET_CONFLICT:
21a0: 0a 2a 2a 20 20 20 43 48 41 4e 47 45 53 45 54 5f  .**   CHANGESET_
21b0: 43 4f 4e 46 4c 49 43 54 20 69 73 20 70 61 73 73  CONFLICT is pass
21c0: 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64  ed as the second
21d0: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65   argument to the
21e0: 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20 20 20 68   conflict.**   h
21f0: 61 6e 64 6c 65 72 20 77 68 69 6c 65 20 70 72 6f  andler while pro
2200: 63 65 73 73 69 6e 67 20 61 6e 20 55 50 44 41 54  cessing an UPDAT
2210: 45 20 6f 72 20 61 6e 20 49 4e 53 45 52 54 20 69  E or an INSERT i
2220: 66 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20  f the operation 
2230: 77 6f 75 6c 64 0a 2a 2a 20 20 20 72 65 73 75 6c  would.**   resul
2240: 74 20 69 6e 20 64 75 70 6c 69 63 61 74 65 20 70  t in duplicate p
2250: 72 69 6d 61 72 79 20 6b 65 79 20 76 61 6c 75 65  rimary key value
2260: 73 2e 0a 2a 2a 20 0a 2a 2a 20 20 20 54 68 65 20  s..** .**   The 
2270: 63 6f 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 20  conflicting row 
2280: 69 6e 20 74 68 69 73 20 63 61 73 65 20 69 73 20  in this case is 
2290: 74 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 77  the database row
22a0: 20 77 69 74 68 20 74 68 65 20 6d 61 74 63 68 69   with the matchi
22b0: 6e 67 0a 2a 2a 20 20 20 70 72 69 6d 61 72 79 20  ng.**   primary 
22c0: 6b 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 53 51 4c 49  key..** .** SQLI
22d0: 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e  TE_CHANGESET_CON
22e0: 53 54 52 41 49 4e 54 3a 0a 2a 2a 20 20 20 49 66  STRAINT:.**   If
22f0: 20 61 6e 79 20 6f 74 68 65 72 20 63 6f 6e 73 74   any other const
2300: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
2310: 6f 63 63 75 72 73 20 77 68 69 6c 65 20 61 70 70  occurs while app
2320: 6c 79 69 6e 67 20 61 20 63 68 61 6e 67 65 20 28  lying a change (
2330: 69 2e 65 2e 20 0a 2a 2a 20 20 20 61 20 46 4f 52  i.e. .**   a FOR
2340: 45 49 47 4e 20 4b 45 59 2c 20 55 4e 49 51 55 45  EIGN KEY, UNIQUE
2350: 2c 20 43 48 45 43 4b 20 6f 72 20 4e 4f 54 20 4e  , CHECK or NOT N
2360: 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 29 2c  ULL constraint),
2370: 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20 0a 2a   the conflict .*
2380: 2a 20 20 20 68 61 6e 64 6c 65 72 20 69 73 20 69  *   handler is i
2390: 6e 76 6f 6b 65 64 20 77 69 74 68 20 43 48 41 4e  nvoked with CHAN
23a0: 47 45 53 45 54 5f 43 4f 4e 53 54 52 41 49 4e 54  GESET_CONSTRAINT
23b0: 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61   as the second a
23c0: 72 67 75 6d 65 6e 74 2e 0a 2a 2a 20 0a 2a 2a 20  rgument..** .** 
23d0: 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f    There is no co
23e0: 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 20 69 6e  nflicting row in
23f0: 20 74 68 69 73 20 63 61 73 65 2e 20 54 68 65 20   this case. The 
2400: 72 65 73 75 6c 74 73 20 6f 66 20 69 6e 76 6f 6b  results of invok
2410: 69 6e 67 20 74 68 65 0a 2a 2a 20 20 20 73 71 6c  ing the.**   sql
2420: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 63 6f  ite3changeset_co
2430: 6e 66 6c 69 63 74 28 29 20 41 50 49 20 61 72 65  nflict() API are
2440: 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23   undefined..*/.#
2450: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 48  define SQLITE_CH
2460: 41 4e 47 45 53 45 54 5f 44 41 54 41 20 20 20 20  ANGESET_DATA    
2470: 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 51 4c     1.#define SQL
2480: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 4e 4f  ITE_CHANGESET_NO
2490: 54 46 4f 55 4e 44 20 20 20 32 0a 23 64 65 66 69  TFOUND   2.#defi
24a0: 6e 65 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45  ne SQLITE_CHANGE
24b0: 53 45 54 5f 43 4f 4e 46 4c 49 43 54 20 20 20 33  SET_CONFLICT   3
24c0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  .#define SQLITE_
24d0: 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 53 54 52  CHANGESET_CONSTR
24e0: 41 49 4e 54 20 34 0a 0a 2f 2a 20 0a 2a 2a 20 56  AINT 4../* .** V
24f0: 61 6c 69 64 20 72 65 74 75 72 6e 20 76 61 6c 75  alid return valu
2500: 65 73 20 66 72 6f 6d 20 61 20 63 6f 6e 66 6c 69  es from a confli
2510: 63 74 2d 68 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a  ct-handler..**.*
2520: 2a 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53  * SQLITE_CHANGES
2530: 45 54 5f 4f 4d 49 54 3a 0a 2a 2a 20 20 20 49 66  ET_OMIT:.**   If
2540: 20 61 20 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64   a conflict hand
2550: 6c 65 72 20 72 65 74 75 72 6e 73 20 74 68 69 73  ler returns this
2560: 20 76 61 6c 75 65 20 6e 6f 20 73 70 65 63 69 61   value no specia
2570: 6c 20 61 63 74 69 6f 6e 20 69 73 20 74 61 6b 65  l action is take
2580: 6e 2e 20 54 68 65 0a 2a 2a 20 20 20 63 68 61 6e  n. The.**   chan
2590: 67 65 20 69 73 20 6e 6f 74 20 61 70 70 6c 69 65  ge is not applie
25a0: 64 2e 20 54 68 65 20 73 65 73 73 69 6f 6e 20 6d  d. The session m
25b0: 6f 64 75 6c 65 20 63 6f 6e 74 69 6e 75 65 73 20  odule continues 
25c0: 74 6f 20 74 68 65 20 6e 65 78 74 20 63 68 61 6e  to the next chan
25d0: 67 65 0a 2a 2a 20 20 20 69 6e 20 74 68 65 20 63  ge.**   in the c
25e0: 68 61 6e 67 65 73 65 74 2e 0a 2a 2a 0a 2a 2a 20  hangeset..**.** 
25f0: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
2600: 5f 52 45 50 4c 41 43 45 3a 0a 2a 2a 20 20 20 54  _REPLACE:.**   T
2610: 68 69 73 20 76 61 6c 75 65 20 6d 61 79 20 6f 6e  his value may on
2620: 6c 79 20 62 65 20 72 65 74 75 72 6e 65 64 20 69  ly be returned i
2630: 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67  f the second arg
2640: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 63 6f 6e  ument to the con
2650: 66 6c 69 63 74 0a 2a 2a 20 20 20 68 61 6e 64 6c  flict.**   handl
2660: 65 72 20 77 61 73 20 53 51 4c 49 54 45 5f 43 48  er was SQLITE_CH
2670: 41 4e 47 45 53 45 54 5f 44 41 54 41 20 6f 72 20  ANGESET_DATA or 
2680: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
2690: 5f 43 4f 4e 46 4c 49 43 54 2e 20 49 66 20 74 68  _CONFLICT. If th
26a0: 69 73 0a 2a 2a 20 20 20 69 73 20 6e 6f 74 20 74  is.**   is not t
26b0: 68 65 20 63 61 73 65 2c 20 61 6e 79 20 63 68 61  he case, any cha
26c0: 6e 67 65 73 20 61 70 70 6c 69 65 64 20 73 6f 20  nges applied so 
26d0: 66 61 72 20 61 72 65 20 72 6f 6c 6c 65 64 20 62  far are rolled b
26e0: 61 63 6b 20 61 6e 64 20 74 68 65 20 0a 2a 2a 20  ack and the .** 
26f0: 20 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65    call to sqlite
2700: 33 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79  3changeset_apply
2710: 28 29 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54  () returns SQLIT
2720: 45 5f 4d 49 53 55 53 45 2e 0a 2a 2a 0a 2a 2a 20  E_MISUSE..**.** 
2730: 20 20 49 66 20 43 48 41 4e 47 45 53 45 54 5f 52    If CHANGESET_R
2740: 45 50 4c 41 43 45 20 69 73 20 72 65 74 75 72 6e  EPLACE is return
2750: 65 64 20 62 79 20 61 6e 20 53 51 4c 49 54 45 5f  ed by an SQLITE_
2760: 43 48 41 4e 47 45 53 45 54 5f 44 41 54 41 20 63  CHANGESET_DATA c
2770: 6f 6e 66 6c 69 63 74 0a 2a 2a 20 20 20 68 61 6e  onflict.**   han
2780: 64 6c 65 72 2c 20 74 68 65 6e 20 74 68 65 20 63  dler, then the c
2790: 6f 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 20 69  onflicting row i
27a0: 73 20 65 69 74 68 65 72 20 75 70 64 61 74 65 64  s either updated
27b0: 20 6f 72 20 64 65 6c 65 74 65 64 2c 20 64 65 70   or deleted, dep
27c0: 65 6e 64 69 6e 67 0a 2a 2a 20 20 20 6f 6e 20 74  ending.**   on t
27d0: 68 65 20 74 79 70 65 20 6f 66 20 63 68 61 6e 67  he type of chang
27e0: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 66 20 43 48  e..**.**   If CH
27f0: 41 4e 47 45 53 45 54 5f 52 45 50 4c 41 43 45 20  ANGESET_REPLACE 
2800: 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 61  is returned by a
2810: 6e 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53  n SQLITE_CHANGES
2820: 45 54 5f 43 4f 4e 46 4c 49 43 54 20 63 6f 6e 66  ET_CONFLICT conf
2830: 6c 69 63 74 0a 2a 2a 20 20 20 68 61 6e 64 6c 65  lict.**   handle
2840: 72 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6e 66  r, then the conf
2850: 6c 69 63 74 69 6e 67 20 72 6f 77 20 69 73 20 72  licting row is r
2860: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20  emoved from the 
2870: 64 61 74 61 62 61 73 65 20 61 6e 64 20 61 0a 2a  database and a.*
2880: 2a 20 20 20 73 65 63 6f 6e 64 20 61 74 74 65 6d  *   second attem
2890: 70 74 20 74 6f 20 61 70 70 6c 79 20 74 68 65 20  pt to apply the 
28a0: 63 68 61 6e 67 65 20 69 73 20 6d 61 64 65 2e 20  change is made. 
28b0: 49 66 20 74 68 69 73 20 73 65 63 6f 6e 64 20 61  If this second a
28c0: 74 74 65 6d 70 74 20 66 61 69 6c 73 2c 0a 2a 2a  ttempt fails,.**
28d0: 20 20 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20     the original 
28e0: 72 6f 77 20 69 73 20 72 65 73 74 6f 72 65 64 20  row is restored 
28f0: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20  to the database 
2900: 62 65 66 6f 72 65 20 63 6f 6e 74 69 6e 75 69 6e  before continuin
2910: 67 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f  g..**.** SQLITE_
2920: 43 48 41 4e 47 45 53 45 54 5f 41 42 4f 52 54 3a  CHANGESET_ABORT:
2930: 0a 2a 2a 20 20 20 49 66 20 74 68 69 73 20 76 61  .**   If this va
2940: 6c 75 65 20 69 73 20 72 65 74 75 72 6e 65 64 2c  lue is returned,
2950: 20 61 6e 79 20 63 68 61 6e 67 65 73 20 61 70 70   any changes app
2960: 6c 69 65 64 20 73 6f 20 66 61 72 20 61 72 65 20  lied so far are 
2970: 72 6f 6c 6c 65 64 20 62 61 63 6b 20 0a 2a 2a 20  rolled back .** 
2980: 20 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 20 74    and the call t
2990: 6f 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73  o sqlite3changes
29a0: 65 74 5f 61 70 70 6c 79 28 29 20 72 65 74 75 72  et_apply() retur
29b0: 6e 73 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  ns SQLITE_MISUSE
29c0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c  ..*/.#define SQL
29d0: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 4f 4d  ITE_CHANGESET_OM
29e0: 49 54 20 20 20 20 20 20 20 30 0a 23 64 65 66 69  IT       0.#defi
29f0: 6e 65 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45  ne SQLITE_CHANGE
2a00: 53 45 54 5f 52 45 50 4c 41 43 45 20 20 20 20 31  SET_REPLACE    1
2a10: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  .#define SQLITE_
2a20: 43 48 41 4e 47 45 53 45 54 5f 41 42 4f 52 54 20  CHANGESET_ABORT 
2a30: 20 20 20 20 20 32 0a 0a 23 65 6e 64 69 66 0a 0a       2..#endif..